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PREFACE 



MANUAL OBJECTIVES 

This manual provides users of the VAX/VMS operating system with the 
information necessary to interface directly with the I/O device 
drivers supplied as part of the operating system. It is not the 
objective of this manual to provide the reader with information on all 
aspects of VAX/VMS input/output (I/O) operations. 

INTENDED AUDIENCE 

This manual is intended for system programmers who want to take 
advantage of the time and/or space savings that result from direct use 
of the I/O devices. Readers are expected to have some experience with 
either VAX-11 FORTRAN IV-PLUS or VAX- 11 MACRO assembly language. 
Users of VAX/VMS who do not require such detailed knowledge of I/O 

,,fi V ?f S „ Can J use the de vice-independent services described in the 
VAX-11 Record Management Services Reference Manual . 

STRUCTURE OF THIS DOCUMENT 

This manual is organized into ten chapters and two appendixes, as 

• Chapter 1 contains introductory information. It provides 
overviews of VAX/VMS I/O operations; I/O system services; 
and I/O quotas, privileges, and protection. This chapter also 
introduces I/O function encoding and how to make I/O requests, 
and describes how to obtain information on the different 
devices. 

• Chapters 2 through 8 and 10 describe the use of all the I/O 
device drivers supported by VAX/VMS: 

- Chapter 2 deals with the terminal driver 

- Chapter 3 deals with disk drivers 

- Chapter 4 deals with magnetic tape drivers 

- Chapter 5 deals with the line printer driver 

- Chapter 6 deals with the card reader driver 
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- Chapter 7 deals with the mailbox driver 

- Chapter 8 deals with the DMC11 driver 

- Chapter 10 deals with the LPA11-K driver 

• Chapter 9 describes the Queue I/O (QIO) interface to file 
system ancillary control processes (ACPs) . 

• Appendix A describes the QIO functions that are common to the 
disk and magnetic tape drivers and the QIO ACP interface. 

• Appendix B summarizes the QIO function codes, arguments, and 
function modifiers used by the different device drivers. 

ASSOCIATED DOCUMENTS 

The following documents may also be useful: 

m VAX/-11 Information Directory - contains a complete list of 
all VAX-11 documents 

• VAX/VMS System Services Reference Manual 

• VAX-11 Linker Reference Manual 

• VAX-11 Software Handbook 

• PDP-11 Peripherals Handbook 

• VAX-11 FORTRAN IV-PLUS User's Guide 

• VAX-11 MACRO User's Guide 

• VAX-11 Record Management Services Reference Manual 

• LPA1 1-K Laboratory Peripheral Accelerator User's Guide 

CONVENTIONS USED IN THIS MANUAL 

The following conventions are used in this manual: 

• Brackets ([]) in QIO requests enclose optional arguments. For 
example : 

IO$_CREATE PI , [P2] , [P3] , [P4] , [P5] 

• Horizontal ellipses (...) indicate that characters or QIO 
arguments that are not pertinent to the example have been 
omitted. For example: 

(that is, 8, 16, 24 , . . . ) . 

• vertical ellipses in coding examples indicate that lines of 
code not pertinent to the example are omitted. For example: 

TTCHAN: .BLKW 1 



$ASSIGN S DEVNAM=TTNAME,CHAN=TTCHAN 
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Hyphens (-) in coding examples indicate that additional 
arguments to the QIO request are provided on the following 
line(s). For example: 



$QIO_S FUNC=#IO$_WRITEPBLK,- 

CHAN=W"TTCHAN1,- 
EFN=#1,- 
P1=W~ASTMSG,- 
P2=#ASTMSGSIZE 



FUNCTION IS 
WRITE PHYSICAL 
TO TTCHAN 1 
EVENT FLAG 1 
Pi = BUFFER 
P2 = BUFFER SIZE 



• Angle brackets (<>) enclose keys 
For example: 

GjJD <0> <20-2F>...<40-7E> 



on the terminal keyboard. 



Unless otherwise noted, all numbers in the text are assumed to 
be decimal. In coding examples, the radix — binary, octal, 
decimal, or hexadecimal — will be explicitly indicated. 
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See the VAX/VMS System Services Reference Manual for detailed 
information on all these system services and examples of their use. 
The VAX/VMS System Services Reference Manual also contains information 
on physical and logical device-naming conventions. 



1.4 QUOTAS, PRIVILEGES, AND PROTECTION 

To preserve the integrity of the system, VAX/VMS I/O operations are 
performed under the constraints of quotas, privileges, and protection. 

Quotas establish a limit on the number and type of I/O operations that 
a process can perform concurrently. They ensure that all users have 
an equitable share of system resources and usage. 

Privileges are granted to a user to allow the performance of certain 
I/O-related operations; for example, create a mailbox and perform 
logical I/O to a file-structured device. Restrictions on user 
privilege protect the integrity and performance of both the operating 
system and the services provided other users. 

Protection is used to control access to files and devices. Device 
protection is provided in much the same way as file protection: 
shareable and nonshareable file devices and shareable nonfile devices 
such as mailboxes, are protected by protection masks. Nonshareable, 
nonfile devices such as terminals, can be accessed if they are not 
allocated to another process. 

The Set Resource Wait Mode ($SETRWM) system service allows a process 
to select either of two modes when an attempt to exceed a quota 
occurs. in the enabled (default) mode, the process waits until the 
required resource is available before continuing. In the disabled 
mode, the process is notified immediately by a system service status 
return that an attempt to exceed a quota has occurred. Waiting for 
resources is transparent to the process when resource wait mode is 
enabled; no explicit action is taken by the process when a wait is 
necessary. 

The different types of I/O-related quotas, privileges, and protection 
are described in the following paragraphs. 



1.4.1 Buffered I/O Quota 

The buffered I/O quota specifies the maximum number of concurrent 
buffered I/O operations a process can have active. In a buffered I/O 
operation, the user's data is buffered in system dynamic memory. The 
driver deals with the system buffer and not the user buffer. Buffered 
I/O is used for terminal, line printer, card reader, and mailbox 
transfers. The user's buffer does not have to be locked in memory for 
a buffered I/O operation. 

The buffered I/O quota value is established in the user authorization 
file by the system manager or by the process's creator. Resource wait 
mode is entered if enabled by the Set Resource Wait Mode system 
service and an attempt to exceed the buffered I/O quota is made. 
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1.4.2 Buffered I/O Byte Count Quota 

The buffered I/O byte count quota specifies the maximum amount of 
buffer space that can be concurrently consumed from system dynamic 
memory for buffering I/O requests. All buffered I/O requests require 
system dynamic memory in which the actual I/O operation takes place. 

The buffered I/O byte count quota is established in the user 
authorization file by the system manager or by the process's creator. 
Resource wait mode is entered if enabled by the Set Resource Wait Mode 
system service and an attempt to exceed the buffered I/O byte count 
quota is made. 



1.4.3 Direct I/O Quota 

The direct I/O quota specifies the maximum number of concurrent 
direct, that is, unbuffered, I/O operations that a process can have 
active. In a direct I/O operation, data is moved directly to or from 
the user buffer. Direct I/O is used for disk, magnetic tape, and 
DMC11 transfers. For direct I/O, the user's buffer must be locked in 
memory during the transfer. 

The direct I/O quota value is established in the user authorization 

file by the system manager or by the process's creator. Resource wait 

mode is entered if enabled by the Set Resource Wait Mode system 

service and an attempt to exceed the direct I/O quota is made. 



1.4.4 AST Quota 

The AST quota specifies the maximum number of asynchronous system 
traps that a process can have outstanding. The quota value is 
established in the user authorization file by the system manager or by 
the process's creator. There is never an implied wait for this 
resource. 



1.4.5 Physical I/O Privilege (PHY_IO) 

Physical I/O privilege allows a process t6 perform physical I/O 
operations on a device. Physical I/O privilege also allows a process 
to perform logical I/O operations on a device. (Figures 1-1 and 1-2 
show the use of physical I/O privilege in greater detail.) 



1.4.6 Logical I/O Privilege (LOG_IO) 

Logical I/O privilege allows a process to perform logical I/O 
operations on a device. A process can also perform physical 
operations on a device if the process has logical I/O privilege, the 
volume is mounted foreign, and the volume protection mask allows 
access to the device. (Figures 1-1 and 1-2 show the use of logical 
I/O privilege in greater detail.) 



1-4 February 1979 



INTRODUCTION TO VAX/VMS INPUT/OUTPUT 



1.4.7 Mount Privilege 

Mount privilege allows a process to use the IO$_MOUNT function to 
perform mount operations on disk and magnetic tape devices. IO$_MOUNT 
is used in ACP interface operations (see chapter 9) . 



1.4.8 Volume Protection 

Volume protection protects the integrity of mailboxes and both foreign 
and Files-11 structured volumes. Volume protection for a foreign 
volume is established when the volume is mounted. Volume protection 
for a Files-11 structured volume is established when the volume is 
initialized. (The protection can be overridden when the volume is 
mounted if the process that is mounting the volume has the override 
volume protection privilege.) 



Mailbox protection is established 
protection mask argument. 



by the $CREMBX system service 



Protection for structured volumes and mailboxes is provided by a 
volume protection mask that contains four 4-bit fields. These fields 
correspond to the four classes of users that are permitted to access 
the volume. (User classes are based on the volume -owner's user 
identification code (UIC).) 

The 4-bit fields are interpreted differently for volumes that are 
mounted as structured (that is, volumes serviced by an Ancillary 
Control Process (ACP)) and volumes that are mounted as foreign. 



The 4-bit fields have the following 
structured: 



format for volumes mounted as 



15 



11 



world 


group 


owner 


system 




10 



delete 


execute 


write 


read 



The 4-bit fields have the following format for volumes mounted as 
foreign: 



11 



10 



Log I/O 


Phy I/O 


* 


* 



'not used 

Usually, volume protection is meaningful only for read and write 
pperations. 
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1.5 SUMMARY OF VAX/VMS QIO OPERATIONS 

VAX/VMS provides QIO operations that perform three basic I/O 
functions: read, write, and set mode. The read function transfers 
data from a device to a user-specified buffer. The write function 
transfers data in the opposite direction - from a user-specified 
buffer to the device. For example, in a read QIO function to a 
terminal device, a user-specified buffer is filled with characters 
received from the terminal. In a write QIO function to the terminal, 
the data in a user-specified buffer is transferred to the terminal 
where it is displayed. 

The set mode QIO function is used to control or describe the 
characteristics and operation of a device. For example, a set mode 
QIO function to a line printer can specify either uppercase or 
lowercase character format. Not all QIO functions are applicable to 
all types of devices. The line printer, for example, cannot perform a 
read QIO function. 



1.6 PHYSICAL, LOGICAL, AND VIRTUAL I/O 

I/O data transfers can occur in any one of three device addressing 
modes: physical, logical, or virtual. Any process with device access 
allowed by the volume protection mask can perform logical I/O on a 
device that is mounted foreign; physical I/O requires privilege. 
Virtual I/O does not require privilege; however, intervention by an 
ACP to control user access may be necessary if the device is under ACP 
control. (ACP functions are described in Chapter 9.) 



1.6.1 Physical I/O Operations 

In physical I/O operations, data is read from and written to the 

actual, physically addressable units accepted by the hardware; for 

example, sectors on a disk or binary characters on a terminal in the 

PASSALL mode. This mode allows direct access to all device-level I/O 
operations. 

Physical I/O requires that one of the following conditions be met: 

• The issuing process has physical I/O privilege (PHY_IO) 

• The issuing process has logical I/O privilege (LOG_IO) , the 
device is mounted foreign, and the volume protection mask 
allows physical access to the device 

If neither of these conditions is met, the physical I/O operation is 
rejected by the QIO system service with a status return of SS$_NOPRIV 
(no privilege) . Figure 1-1 illustrates the physical I/O access checks 
in greater detail. 
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QIO 
REQUEST 




YES 




YES 




TRANSLATE LOGICAL 
BLOCK ADDRESS 

TO PHYSICAL 
BLOCK ADDRESS 



YES 



MAP VIRTUAL BLOCK 

ADDRESS TO LOGICAL 

BLOCK ADDRESS 




I/O 
DRIVER 



YES 



GOTO 

ACP 



WAKEACPTO 

CHANGE MAPPING 

WINDOW 



X 



'Needed to map virtual address to logical address 



Figure 1-3 Physical, Logical, and Virtual I/O 
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1.7 I/O FUNCTION ENCODING 

I/O functions fall into three groups that correspond to the three I/O 
device addressing modes (physical, logical, and virtual) described in 
Section 1.6. Depending on the device to which it is directed, an I/O 
function can be expressed in one, two, or all three modes. 

I/O functions are described by 16-bit, symbolically-expressed values 
that specify the particular I/O operation to be performed and any 
optional function modifiers. Figure 1-4 shows the format of the 
16-bit function value. 



15 



6 5 



function modifiers 



code 



Figure 1-4 I/O Function Format 

Symbolic names for I/O function codes are defined by the $IODEF macro 
as described in the VAX/VMS System Services Reference Manual. 



1.7.1 Function Codes 

The low-order 6 bits of the function value are a code that specifies 
the particular operation to be performed. For example, the code for 
read logical block is expressed as IO$_READLBLK . Table 1-1 lists the 
symbolic values for read and write I/O functions in the three transfer 
modes. 



Table 1-1 
Read and Write I/O Functions 



Physical I/O 


Logical l/o 


Virtual I/O 


10$ READPBLK 
IO$_WRITEPBLK 


10$ READLBLK 
IO$~WRITELBLK 


10$ READVBLK 
IO$~WRITEVBLK 



The set mode I/O function has a symbolic value of I0$_SETM0DE. 

Function codes are defined for all supported devices. Although some 
of the function codes (for example, IO$_READVBLK and 10$ WRITEVBLK) 
are used with several types of devices, most are device ~dependent. 
That is, they perform functions specific to particular types of 
devices. For example, 10$ CREATE is a device-dependent function code; 
it is used only with Tile-structured devices such as disks and 
magnetic tapes. Chapters 2 through 8 and 10 
descriptions of the functions and function codes. 



provide complete 



1.7.2 Function Modifiers 

The high-order 10 bits of the function value are function modifiers. 
These are individual bits that alter the basic operation to be 
performed. For example, the function modifier I0$M NOECHO can be 
specified with the function IO$_READLBLK to a terminal. When used 
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The number of pending I/O requests, the amount of buffer space, and 
the number of outstanding ASTs that a process can have are controlled 
by quotas. 

Each I/O request causes an I/O request packet to be allocated from 
system dynamic memory. Additional memory is allocated under the 
following circumstances: 

• The I/O request function is an ACP function 

• The target device is a buffered I/O device 

• The target device is a network I/O device 

After an I/O request is queued, the system does not require the 
issuing process to wait for the I/O operation to complete. If the 
process that issued the QIO request cannot proceed until the I/O 
completes, an event flag can be used to synchronize I/O completion 
(see Sections 1.8.6.1 and 1.9.1). In this case, the process should 
request the Wait for Single Event Flag ($WAITFR) system service at the 
point where synchronization must occur: that is, where I/O completion 
is required. 

$WAITFR specifies an event flag for which the process is to wait. 
(The $WAITFR event flag must have the same number as the event flag 
used in the QIO request.) The process then waits while the I/O 
operation is performed. On I/O completion, the event flag is set and 
the process is allowed to resume operation. 

Other ways to achieve this synchronization include the use of the 
$0I0W system service and ASTs, described in Sections 1.8.5 and 1.9.3, 
respectively. In addition, the I/O status block can be specified and 
checked if the user wants to determine whether the I/O operation 
completed without an error, regardless of whether or not the process 
waits for I/O completion (see Section 1.9.2.) 

The QIO system service is accompanied by up to six device/ function 
independent and six device/function dependent arguments. Section 
1.8.6 below describes device/function independent arguments. The 
device/function dependent arguments (Pi through P6) are potentially 
different for each device/function combination. However, similar 
functions that are performed by all devices have identical arguments. 
Furthermore, all functions performed by a particular class of device 
are identical. Device/function dependent arguments are described in 
more detail for the individual devices in Chapters 2 through 8 and 10. 



1,8.4 $QI0 Macro Format 

The general format for the $QI0 macro, using position-dependent 
arguments, is: 

$QI0 S [efn] ,phan,func, [iosb] , [astadr] , [astprm] ,- 
[Pl],[p2],[p3j,lp4),tp5],[p6] 

The first six arguments are device/function independent. If keyword 
arguments are used, they can be written in any order. Arguments PI 
through P6 are device/function dependent. The chan and func arguments 
must be specified in each request; arguments enclosed in brackets 
( [] ) are optional. 
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The following example illustrates a typical QIO request using keyword 
arguments: 



$QIO_S EFN=#1,- 

CHAN=TTCHAN1,- 
FUNC=#IO$_WRITEVBLK,- 
P1=BUFADD,- 
P2=#BUFSIZE 



; EVENT FLAG 1 
; CHANNEL 
/VIRTUAL WRITE 
; BUFFER ADDRESS 
; BUFFER SIZE 



1.8.5 $QIOW Macro Format 

The Queue I/O Request and Wait For Event Flag ($QIOW) system service 
macro combines the $QIO and $WAITFR system services. It eliminates 
any need for explicit I/O synchronization by automatically waiting 
until the I/O operation is completed before returning control to the 
process. Thus, $QIOW provides a simpler way to synchronize the return 
to the originating process when the process cannot proceed until the 
I/O operation is completed. 



The $QIOW macro has the same device/function independent 
device/function dependent arguments as the $QIO macro: 

$QIOW_S [efn] ,chan,func, [iosb] , [astadr] , [astprm] ,- 
[Pl],[p2],[p3],[p4],[p5],[p6] 



and 



1.8.6 $QIO and $QIOW Arguments 

Table 1-2 lists the $QIO and $QIOW device/function independent 
arguments and their meanings. Additional information is provided in 
the paragraphs following the table and in the VAX/ VMS Syste m Services 
Reference Manual. 



Table 1-2 
Device/Function Independent Arguments 



Argument 



efn (event 
flag number) 



chan (channel 
number) 



f unc 

(function value) 



iosb (I/O 
status block) 



Meaning 



The number of the event flag that is to be 
cleared when the I/O function is queued and set 
when it is completed. This argument is optional 
in the macro form; if not specified, efn 
defaults to 0. 

The number of the I/O channel to which the 
request is directed. The channel number is 
obtained from either the $ASSIGN or $CREMBX system 
service. This argument is mandatory in the macro 
form. 

The 16-bit function code and modifier value that 
specifies the operation to be performed. This 
argument is mandatory in the macro form. 

The address of a quadword I/O status block to 
receive the final I/O status. This argument is 
optional in the macro form. 



(Continued on next page) 
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Argument 



astadr (AST 
address) 



astprm (AST 
parameter) 



Table 1-2 (Cont.) 
Device/Function Independent Arguments 



Meaning 



The entry point address of an AST routine to be 
asynchronously executed when the I/O completes. 
This argument is optional in the macro form. 

The 32-bit value to be passed to the AST routine 
as an argument when the I/O completes. It can be 
used to assist the routine in identifying the 
particular AST. This argument is optional in the 
macro form. 



1.8.6.1 Event Flag Number Argument - The event flag number < efn ) 
argument is the number of the event flag to be associated with the I/O 
operation. It is optional in a $QIO or $QIOW macro. The specified 
event flag is cleared when the request is issued and set when the I/O 
operation completes. The specified event flag is also set if the 
service terminates without queuing the I/O request. 



If the process requested the $QIOW system service, execution is 
automatically suspended until the I/O completes. If the process 
requested the QIO system service (with no subsequent $WAITFR, $WFLOR, 
or $WFLAND macro), process execution proceeds in parallel with the 
I/O As the process continues to execute, it can test the event flag 
at any point by using the Read Event Flags ($READEF) system service. 

Event flag numbers must be in the range of through 127 (however, 
event flags 24 through 31 are reserved for system use). If no 
specific event flag is desired, the efn argument can be omitted from 
the macro. In that case,, efn defaults to 0. 



1.8.6.2 Channel Number Argument - The channel number (chan) argument 
represents the channel number of the physical device to be accessed by 
the I/O request. It is required for all $QI0 and $QI0W requests. The 
association between the physical device and the channel is specific to 
the process issuing the I/O request. The channel number is obtained 
from the $ASSIGN or $CREMBX system service (as described above in 
Section 1.8.1) . 



1.8.6.3 Function Argument - The function (func) argument defines the 
logical, virtual, or physical I/O operation to be performed when the 
$010 or $QI0W system service is requested. It is required for all QIO 
and QIOW requests. The argument consists of a 16-bit function code 
and function modifier. Up to 64 function codes can be 
Function codes are defined for all supported device types; 
the codes are device dependent. The function arguments for 
driver are described in more detail in Chapters 2 through 8 and 10 



defined, 
most of 
each I/O 
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1.8.6.4 I/O Status Block Argument - The I/O status block (iosb) 
argument specifies the address of the I/O status block to be 
associated with the I/O request. It is optional in the QIO and QIOW 
macros. If omitted, the iosb value is which indicates no iosb 
address is supplied. This block is a quadword that receives the final 
completion status of the I/O request. Section 1.9.2 describes the I/O 
status block in more detail. 



1.8.6.5 AST Address Argument - The AST address (astadr) argument 
specifies the entry point address of an AST routine to be executed 
when the I/O operation is complete. If omitted, the astadr value is 
which indicates no astadr address is supplied. This argument is 
optional and can be used to interrupt a process to execute special 
code at I/O completion. When the I/O operation completes, the AST 
service routine is CALLed at the address specified in the astadr 
argument. The AST service routine is then executed in the access mode 
from which the QIO service was requested. 



1.8.6.6 AST Parameter Argument - The AST parameter (astprm) argument 
is an optional, 32-bit arbitrary value that is passed to the AST 
service routine when I/O completes, to assist the routine in 
identifying the particular AST. A typical use of the astprm argument 
might be the address of a user control block. If omitted, the astprm 
value is 0. 



1.8.6.7 Device/Function Dependent Arguments - Up to six 
device/function dependent arguments (Pi through P6) can be included in 
each QIO request. The arguments for terminal read function codes show 
a typical use of PI through P6: 

Pi = buffer address 

P2 =» buffer size 

P3 = timeout count (for read with timeout) 

P4 = read terminator descriptor block address 

P5 => prompt string buffer address 

P6 = prompt string buffer size 

PI is always treated as an address. Therefore, in the _S form of the 
macro, PI always generates a PUSHAB instruction. P2 through P6 are 
always treated as values. In the _S form of the macro, these 
arguments always generate PUSHL instructions. 

Inclusion of the device/function dependent arguments in a QIO request 
depends on the physical device unit and the function specified. A 
user who wants to specify only a channel, an I/O function code, and an 
address for AST routine might issue the following: 

$QIO_S CHAN=XYCHAN,FUNC=#IO$_READVBLK,- 
ASTADR=XYAST,P1=BUFADR,P2=#BUFLEN 
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In this example, XYCHAN is the address of the word containing the 
channel to which the request is directed; IO$_READVBLK is the 
function code; and XYAST is the AST entry point address. BUFADR and 
BUFLEN are the device/function dependent arguments for an input 
buffer. 



1.8.7 $INPUT and $OUTPUT Macro Format and Arguments 

The $INPUT and $OUTPUT macros simplify the use of the $QIOW macro. 
These macros generate code to perform virtual operations, using the 
10$ READVBLK and IO$_WRITEVBLK function codes (the function code is 
automatically specified in the request), and wait for I/O completion. 
The macro formats and arguments are: 

$INPUT chan, length, buffer, [iosb] , [efn] 
$0UTPUT chan, length, buffer, [iosb] , [efn] 

Table 1-3 lists the $INPUT and $0UTPUT arguments and their meanings. 



Table 1-3 
$INPUT and $0UTPUT Arguments 



Argument 



chan 

length 
buffer 
iosb 

efn 



Meaning 



The channel on which the I/O operation is to be 
performed. 

The length of the input or output buffer. 

The address of the input or output buffer. 

The address of the quadword that receives the 
completion status of the I/O operation. This 
argument is optional,. 

The number of the event flag for which the process 
waits. This argument is optional; if not specified, 
efn defaults to 0. 



Both the iosb and efn arguments are optional; all other arguments 
must be included in each macro. Note that the order of the length and 
buffer arguments is opposite that of the QIO and QIOW PI and P2 
arguments. Also note that $INPUT and $0UTPUT do not have the astadr 
and astprm arguments; neither of these operations can conclude in an 
AST. 



1.8.8 Status Returns for System Services 

On completion of a system service call, the completion status is 
returned as a longword value in register R0 , shown in Figure 1-6. 
(System services save the data in all registers except RO and Rl.) 
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RO: 




Figure 1-6 System Service Status Return 



Completion status is indicated by a value in bits through 15. The 
low-order 3 bits are encoded with the error severity level; all 
successful returns have an odd value: 

= warning 

1 = success 

2 = error 

3 = informational (nonstandard) success 

4 = severe error 
5-7 = reserved 

Each numeric status code has a symbolic name in the form SS$ code. 
For example, the return might be SS$_NORMAL, which indicates 
successful completion of the system service. There are several error 
conditions that can be returned. For example, SS$ IVCHAN indicates 
that an invalid channel number was specified in an 1/(5 request. 

The VAX/VMS System Service Reference Manual describes the possible 
returns for each system service. Table 1-4 lists the valid status 
returns for the $QIO, $QIOW, $INPUT, and $OUTPUT system service 
requests. 



Table 1-4 
$QIO, $QIOW, $INPUT, and $OUTPUT System Services Status Returns 



Status 



SS$_NORMAL 

SS$ ACCVIO 
SS$ EXQUOTA 



SS$_ILLEFC 
SS$ INSFMEM 



Meaning 



The $QIO, $QIOW, $INPUT, or $OUTPUT request was 
successfully completed; that is, an I/O request 
was placed in the appropriate device queue. 

The IOSB, the specified buffer, or the argument 
list cannot be accessed by the caller. 

The buffer quota, buffered I/O quota, or direct 
I/O quota was exceeded and the process has 
disabled resource wait mode with the $SETRWM 
system service. (The $SETRWM system service is 
described in Section 1.4.) SS$ EXQUOTA is also 
set if the AST quota was exceeded. 

An illegal event flag number was specified. 

Insufficient dynamic memory is available to 
complete the service and the process has 
disabled resource wait mode with the $SETRWM 
system service. (The $SETRWM system service is 
described in Section 1.4.) 



(Continued on next page) 
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Table 1-4 (Cont.) 
$QIO, $QIOW, $INPUT, and $OUTPUT System Services Status Returns 



Status 



SS$ IVCHAN 



SS$ NOPRIV 



SS$ UNASEFC 



Meaning 



An invalid channel number was specified; that 
is, a channel number larger than the number of 
channels available. 

The specified channel was assigned from a more 
privileged access mode, the channel is not 
assigned, or the user does not have the proper 
privilege to access the device. 



A common event flag in an 
flag cluster was specified. 



unassociated event 



Status returns for systems se 
returns described in Chapters 
drivers (see Section 1.9). A 
status of the $QIO, $QIOW, 
call after completion of the 
returns control to the user, 
reflect the completion (succe 
I/O operation. For example 
terminal might be successful 
because of a device parity 
System service error status r 
invoke the service. 



rvices are not the same as the I/O status 

2 through 8 and 10 for the different I/O 

system service status return is the 

$INPUT, $OUTPUT, or other system service 

service, that is, after the system 

A system service status return does not 

ssful or unsuccessful) of the requested 

, a $QIO system service read request to a 

(status return is SS$_NORMAL) but fail 

error (I/O status return is SS$_PARITY) . 

eturn codes refer only to failures to 



An I/O status return is the status at the completion of the I/O 
operation. It is returned in the quadword I/O status block (IOSB) . 
Although some of the symbolic names (for example, SS$_NORMAL and 
SS$ ACCVIO) can be used in both types of status returns, they have 
different meanings. 



1.9 I/O COMPLETION 

Whether an I/O request completed successfully or unsuccessfully can be 
denoted by one or more return conditions. The selection of the return 
conditions depends on the arguments included in the QIO macro call. 
The three primary returns are: 



Event flag — an event flag is 
operation. 



set on completion of an I/O 



I/O status block — if the iosb argument was specified in the 
QIO macro call, a code identifying the type of success or 
failure is returned in bits through 15 of a quadword I/O 
status block on completion of the I/O operation. The location 
of this block is indicated by the user-supplied iosb argument. 

Asynchronous system trap — if an AST address argument was 
specified in the I/O request, a call to the AST service 
routine occurs, at the address indicated, on completion of the 
I/O operation. (The I/O status block, if specified in the I/O 
request, is updated prior to the AST call.) 
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1.9.1 Event Flags 

Event flags are status posting bits used by the $QIO, $QIOW, $INPUT, 
and $OUTPUT system services to indicate the completion or occurrence 
of an event. The system service clears the event flag when the 
operation is queued and sets it when the operation is completed. 
Event flag services allow users to set or clear certain flags, test 
the current status of flags, or place a program in a wait state 
pending the setting of a flag or group of flags. 



See the VAX/VMS System Services Reference Manual for more 
on event flags and their use. 



information 



1.9.2 I/O Status Block 

The completion status of an I/O request is returned in the first 
of the I/O status block (IOSB) , as shown in Figure 1-7. 

31 16 15 n 



word 



transfer count 



status 



device-dependent data 



Figure 1-7 I/O Status Block Format 



The IOSB indicates whether the oper 
the amount of data transferred, 
information such as the number of 1 
code has the same format and bi 
success; bit clear indicates err 
code (see Section 1.8.8). For 
access a nonexistent disk, a status 
in the I/O status block. The st 
drivers are listed in Chapters 2 th 



ation was successfull 
and additional dev 
Ines printed. The s 
t significance (bit 
or) as the system se 
example, if the proces 

code of SS$_NONEXDRV 
atus returns for the i 
rough 8 and 10. 



y completed, 
ice-dependent 
tatus return 
set indicates 
rvice status 
s attempts to 
is returned 
ndividual I/O 



The upper ha 
on completi 
transfer of 
operation is 
a carriage r 
device and a 
the number o 
IOSB can 
information 
2 through 8 



If of the fi 
on of the 
data to or f 

performed o 
eturn is ind 

read functi 
f bytes actu 

contain c 
is supplied 
and 10. 



rst IOSB longword conta 
I/O operation if the 
rom a user buffer. For 
n a terminal, the numbe 
icated here. If a magn 
on is specified, the tr 
ally transferred. The 
ertain device-depende 
in more detail for each 



ins the transfer count 

operation involved the 

example, if a read 

r of bytes typed before 

etic tape unit is the 

ansfer count represents 

second longword of the 

nt information. This 

I/O driver in Chapters 



The status can be tested symbolically, by name. For example, the 
SS$_NORMAL status is returned if the operation was completed 
successfully. The following example illustrates the examination of 
the I/O status block XYIOSB to determine if an error occurred: 



$QI0_S 
BLBC 



CHAN=XYCHAN,FUNC=#IO$_WRITEVBLK,- 
IOSB=XYIOSB,Pl=BUFADR,P2=#BUFLEN 



R0,REQERR 



; CHECK SYSTEM SERVICE 
/STATUS CODE 



CMPW #SS$_NORMAL, XYIOSB 
BNEQ ERROR 



; CHECK I/O STATUS 
;CODE 
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This chapter describes the use of the VAX/VMS terminal driver. This 
driver supports the DZ-11 Asynchronous Serial Line Multiplexer and the 
console terminal. 



2.1 SUPPORTED TERMINAL DEVICES 

Each DZ-11 multiplexer interfaces 8 or 16 asynchronous serial 
communication lines for use with terminals. It supports programmable 
baud rates; however, input and output speeds must be the same. 
VAX/VMS supports the DZ-11 internal modem control. 

The system console terminal is attached to the processor with a 
special purpose interface. 



2.2 TERMINAL DRIVER FEATURES AND CAPABILITIES 

The VAX/VMS terminal driver provides the following capabilities: 

• Type-ahead 

• Specifiable or default line terminators 

• Special operating modes, such as NOECHO and PASSALL 

• American National Standard escape sequence detection 

• Terminal/mailbox interaction 

• Terminal control characters and special keys 

• Dial-up 

• Optional parity specification 

2.2.1 Type-ahead 

Input (data received) from a VAX/VMS terminal is always independent of 
concurrent output (data sent) to a terminal. This capability is 
called type-ahead. Type-ahead is allowed on all terminals unless 
explicitly disabled by the Set Mode characteristic, inhibit type-ahead 
(TT$M NOTYPEAHD; see Section 2.4.3). 
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Data typed at the terminal is retained in the type-ahead buffer until 
the user program issues an I/O request for a read operation. At that 
time, the data is transferred to the program buffer and echoed at the 
terminal where it was typed. 

Deferring the echo until a read operation is active allows the user 
process to specify function code modifiers that modify the read 
operation. These modifiers can include, for example, noecho 
(IO$M_NOECHO) and convert lowercase characters to uppercase 
(IO$M_CVTLOW) (see Section 2.4.1.1). 

If a read operation is already in progress when the data is typed at 
the terminal, the data transfer and echo are immediate. 

The action of the driver when the type-ahead buffer fills depends on 
the Set Mode characteristic TT$M_HOSTSYNC (see Section 2.4.3). If 
TT$M_HOSTSYNC is not set, CTRL/G (BELL) is returned to inform the user 
that the type-ahead buffer is full. If TT$M_HOSTSYNC is set, the 
driver stops input by sending a CTRL/S and the terminal responds by 
sending no more characters. These warning operations are begun 8 
characters before the type-ahead buffer fills. The driver sends a 
CTRL/Q to restart transmission when the type-ahead buffer empties 
completely. 

The VAX/VMS System Manager's Guide describes the type-ahead buffer 
size. 



2.2.2 Line Terminators 

A line terminator is the control sequence that the user types at the 
terminal to indicate the end of an input line. Optionally, the user 
process can specify a particular line terminator or class of 
terminators for read operations. 

Terminators are specified by an argument to the QIO request for a read 
operation. By default, they can be any ASCII control character except 
FF, VT, TAB, or BS. If included in the request, the argument is a 
user-selected group of characters (see Section 2.4.1.2) . 

All characters are 7-bit ASCII characters unless data is input on an 
8-bit terminal (see Section 2.4.1). (The characteristic TT$M_EIGHTBIT 
determines whether the terminal uses the 7-bit or 8-bit character set; 
see Table 2-4.) All input characters are tested against the selected 
terminator (s) . The input is terminated when a match occurs or the 
user's input buffer fills. 



2.2.3 Special Operating Modes 

The VAX/VMS terminal driver supports many special operating modes for 
terminal lines. Section 2.4.3 lists these modes. All special modes 
are enabled or disabled by the Set Mode QIO. 



2.2.4 Escape Sequences 

Escape sequences are strings of two or more characters, beginning with 
the escape character (decimal 27 or hexadecimal IB), that indicate 
that control information follows. Many terminals send and respond to 
such escape sequences to request special character sets or to indicate 
the position of a cursor. 
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The Set Mode 
specify tha 
sequences, 
verifies the 
considered a 
buffer, that 
not part of 
comprises th 
the read buff 
the terminati 



characteristic TT$M_ESCAPE (see 

t VAX/VMS terminal lines ca 

If this characteristic is s 

syntax of the escape sequence 

read function terminator and i 

is, a read buffer can contain 

an escape sequence, but an 

e last characters in a buffer. 

er and I/O status block include 

ng escape sequence in the data 



Section 2.4.3) is used to 
n generate valid escape 
et, the terminal driver 
s. The sequence is always 
s returned in the read 

other characters that are 
escape sequence always 

The return information in 
s the position and size of 
record (see Section 2.5). 



Any escape sequence received from the terminal is checked for correct 
syntax. If the syntax is not correct, SS$_BADESCAPE is returned as 
the status of the I/O. If the escape sequence does not fit in the 
user buffer, SS$_PARTESCAPE is returned. The remaining characters are 
transmitted on the next read. No syntax integrity is guaranteed 
across read operations. Escape sequences are never echoed. Valid 
escape sequences are any of the following forms (hexadecimal 
notation) : 

<int>.. .<int> <fin> 



where: 



( ESC ) 

<int> 



<fin> 



is pressing the QE) key, a byte (character) of IB 

is an "intermediate character" in the range of 20 to 2F. 
This range includes the character "space" and 15 punctuation 
marks. An escape sequence can contain any number of 
intermediate characters, or none. 

is a "final character" in the range of 30 to 7E. This range 
includes uppercase and lowercase letters, numbers, and 13 
punctuation marks. 



There are four additional escape sequence forms: 

C"5T) <;> <20-2F>...<30-7E> 
GiD <?> <20-2F>...<30-7E> 
CUD <0> <20-2F>...<40-7E> 
fisT) <Y> <20-7E>...<20-7E> 



For example, when the IDENTIFY escape sequence, escap e Z , is sent to a 
VT-55 terminal, the response from the terminal is ( esc ) <C>. (Escape 
sequences are neither displayed nor echoed on the terminal.) 



Section 2.2.6 describes 
sequences. 



control character functions during escape 



2.2.5 Terminal/Mailbox Interaction 

Mailboxes are virtual I/O devices used for communication between 
processes. The terminal driver can use a mailbox to communicate with 
a user process. Chapter 7 describes the mailbox driver. 

A user program can use the $ASSIGN system service to associate a 
mailbox with one or more terminals. The terminal driver sends 
messages to this mailbox when terminal-related events occur that 
require the attention of the user image. 
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Mailboxes used in this way carry status messages, not terminal data, 
from the driver to the user program. For example, when data is 
received from a terminal for which no read request is outstanding 
(unsolicited data), a message is sent to the associated mailbox to 
indicate data availability. On receiving this message, the user 
program must read the channel assigned to the terminal to obtain the 
data. Messages are sent to mailboxes under the following conditions: 

• Unsolicited data in the type-ahead buffer. The use of the 
associated mailbox can be enabled and disabled as a 
subfunction of the read and write QIO requests (see Sections 
2.4.1 and 2.4.2). Thus, the user process can enter into a 
dialog with the terminal after an unsolicited data message 
arrives. Then, after the dialog is over, the user process can 
re-enable the unsolicited data message function on the last 
I/O exchange. The default for all terminals is enabled. Only 
one message is sent between read operations. 

• Terminal hang-up. Hang-up occurs when a remote line loses the 
carrier signal; a message is sent to the mailbox. When 
hang-up occurs on lines that have the characteristic 
TT$M_REMOTE set, the line characteristics are returned to the 
system default characteristics (see the VAX/VMS System 
Generation Reference Manual ) . " 

Messages placed in the mailbox have the following content and format: 

• Message type. The codes MSG$_TRMUNSOLIC (unsolicited data) 
and MSG$_TRMHANGUP (hang-up) identify the type of message. 
Message types are defined by the $MSGDEF macro. 

• Device unit number to identify the terminal that sent the 
message. 

• Counted string to specify the device name. 

• Controller name 



Figure 2-1 illustrates this format. 

31 16 15 



8 7 



unit number 



message type 



controller name* 



counted string 



*does not include the colon (:) character 

Figure 2-1 Terminal Mailbox Message Format 
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INPUT 
CHARACTER 




STRIP BIT 7 

FROM 

CHARACTER VALUE 



CHARACTER 

TO TYPE-AHEAD 

BUFFER 




YES 



PERFORM 
FUNCTION 



DONE 




CONVERT TO 
UPPERCASE 



tAN FUNCTION\YES 
yBEPERFORMED?> 



1. TTSM_PASSALL or IO$_READPBLK 

2. Except for CTRL/X, the function must 
be enabled. For example, CTRL/S is not 
meaningful on a line without the 
TT$M_TTSYNC characteristic. 



Figure 2-2 Character Interpretation 
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2.2.7 Dial-up 

VAX/VMS supports the DZ-11 internal modem control (for example, Bell 
103A, Bell 113, or equivalent) in autoanswer, full-duplex mode. The 
terminal driver does not support half-duplex operations on modems such 
as the Bell 202. The terminal characteristic TT$M_REMOTE designates 
the line as being remote to the local computer. The driver 
automatically sets TT$M_REM0TE if the carrier signal changes from off 
to on. 

Dial-up lines are monitored periodically to detect a change in the 
modem carrier signal. The monitoring period is a system parameter. 
The VAX/VMS System Manager's Guide describes the dial-up monitoring 
period. 



If a line's carrier signal is 
periods for the carrier si 
not detected during this time 
action signals the owner of 
the line is no longer in use. 
unsolicited character messa 
data is received.) The line i 
after the hang-up sequence 
reversible. If the line ha 
delivered; the CTRL/Y AST P2 
The I/O operation in progres 
SS$ ABORT is returned in the 



lost, the driver waits several monitor 
gnal to return. If the carrier signal is 
, the line is "hung-up." The hang-up 
the line, through a mailbox message, that 
(No dial-in message is sent; the 
ge is sufficient when the first available 
s not available for two monitor periods 
begins. The hang-up sequence is not 
ngs up, all enabled CTRL/Y ASTs are 

argument is overwritten with SS$_HANGUP. 
s is cancelled and the status value 
IOSB. 



When a line with the TT$M_REM0TE characteristic is hung-up, the 
characteristics of the line are returned to the system default 
characteristics. 



2.3 DEVICE INFORMATION ' 

The user process can obtain terminal characteristics by using the 
$GETCHN and $GETDEV system services (see Section 1.10). The 
terminal-specific information is returned in the first three longwords 
of a user-specified buffer, as shown in Figure 2-3 (Figure 1-9 shows 
the entire buffer). 



31 



24 23 



16 15 



8 7 



device characteristics 


page width 


type 


class 


page length 


terminal characteristics 













Figure 2-3 Terminal Information 



The first longword contains device-independent data. The second and 
third longwords contain device-dependent data. 

Table 2-3 lists the device-independent characteristics returned in the 
first longword. 
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In a 

assoc 

witho 

mode. 

speci 

puts 

the r 

compr 

TT$M_ 

when 



read physical block operation, the data 
iated terminal is placed in the user buffer as 
ut interpretation; the terminal line is in a 

Since IO$_READPBLK is a physical I/O 
fied only by a privileged user (see Section 1. 
the terminal line in a PASSALL mode which is 
ead physical block operation. This is in cont 
ehensive PASSALL mode established by the Set 
PASSALL. All input and output data is in 8- 
TT$M PASSALL is set (see Section 2.4.3). 



received 

binary in 

temporary 

function, 

6.1). 10$ 

in effect 

rast with 

Mode chara 

bit binar 



from the 
formation 
PASSALL 
it can be 
_READPBLK 
only for 
the more 
cteristic 
y format 



Since 10$ READPBLK does not purge the type-ahead buffer (unless 
requested - using the I0$M PURGE function modifier) the characters in 
the type-ahead buffer may have been subjected to CTRL/Y/C/S/Q/O 
interpretation (Section 2.2.6.1). (Characters received while the 
10$ READPBLK is in progress are not interpreted.) 



2.4.1.1 Function Modifier Codes for Read QIO Functions - Seven 
function modifiers can be specified with I0$_READVBLK, IO$_READLBLK, 
10$ READPROMPT, and 10$ READPBLK. Table 2-5 lists these function 
modifiers. IO$M_CVTL0W and I0$M_N0FILTR are not meaningful to 
10$ READPBLK. 



Code 



I0$M NOECHO 



I0$M_CVTL0W 

IO$M_N0FILTR 
I0$M TIMED 



I0$M_PURGE 

IO$M_DSABLMBX 
I0$M TRMNOECHO 



Table 2-5 
Read QIO Function Modifiers 



Consequence 



Characters are not echoed (that 
as they are entered at the 



is, displayed) 
keyboard. The 
terminal line can also be set to a "no echo" 
mode by the Set Mode characteristic TT$M_N0ECH0, 
which inhibits all read operation echoing. 

Lowercase alphabetic characters (hexadecimal 61 
to 7A) are converted to uppercase when 
transferred into the user buffer or echoed. 



The termin al driver does not interpret (F^'") i 
<Sjjl/r) , or r5iT) . They are passed to the user. 

The P3 argument specifies the maximum time 
(seconds) that can elapse between characters 
received; that is, the timeout value for the 
read operation. A value of terminates the 
read operation, that is, an I/O timeout occurs, 
if no character is read within 1 second. In 
effect, data is read from the type-ahead buffer 
or an error is returned. 

The type-ahead buffer is purged before the read 
operation begins. 

The mailbox is disabled for unsolicited data. 

The termination character (if any) is not 
echoed. There is no formal terminator if the 
buffer is filled before the terminator is typed. 
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f,*,i;J« Read Function Terminators - The P4 argument to a read 010 
function either specifies the terminator set for the read function or 
P ?i ntS a ^ T the location containing that terminator set. if pT is 
all ASCII characters with a code in the range throuah 31 
(hexadecimal through IF) except LF, VT, FF, TAB an Jz 
terminators. (This is the RMS-32 standard terminatof set?? 

If P4 does not equal 0, it contains the address of a quadword 
either specifies a terminator character bit mask or points 
location containing that bit mask. The quadword has a short form 
a long form, as shown in Figure 2-4. m the short form 
correspondence is between the bit number and the binary value of 
character; the character is a terminator if the bit is set 
example, if bit is set, NULL is a terminator; if bit 9 is set* 
is a terminator. if a character is not specified, it is' 
terminator, since ASCII control characters are in the ranqe 
through 31, the short form can be used in most cases. 

chara??erf° rm *ni° WS T °- * m0re comprehensive set of terminator 
characters. Any mask size equal to or greater than 1 byte is 
acceptable. For example, a mask size of 16 bytes allows all 7b 

fl^lL ?^« C k^ S , t0 be USed 9S terminators; a mask size of 32 bytes 
allows all 8-bit characters to be used as terminators for 8-bit 
terminals. An unspecified mask is assumed to be all 0's. 



that 

to a 

and 

the 

the 

For 

TAB 

not a 

of 



31 



SHORT: 



terminator character bit mask 



31 



LONG: 



16 15 



(not used) 



mask size in bytes 



address of mask 



Figure 2-4 Short and Long Forms of Terminator Mask Quadwords 



2.4.2 Write 

! V hi te ,o Per - t i ^ S dis P} a y the contents of a user-specified buffer on 
the associated terminal. VAX/VMS defines three basic wr I/O 
functions, which are listed with their function codes below- 



• IO$_WRITEVBLK 

• IO$_WRITELBLK 

• 10$ WRITEPBLK 



The write function codes can 
device/function-dependent arguments : 



write virtual block 
write logical block 
write physical block 
take 



the 



following 



• PI - the starting virtual address of the buffer that is to 
be written to the terminal 
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This chapter describes the use of the VAX/VMS Laboratory Peripheral 
Accelerator (LPA11-K) driver and the high level language procedure 
library that interfaces with the LPA11-K driver. The procedure 
library is implemented with callable assembly language routines that 
translate arguments into the format required by the LPA11-K driver and 
handle buffer chaining operations. Routines for microcode loading and 
device initialization are also described. 

This chapter is written with the understanding that the reader has 
access to a copy of the LPA11-K Laboratory Periphera l Accelerator 
User's Guide. 



10.1 SUPPORTED DEVICE 

The LPA11-K is a peripheral device that controls analog to digital 
(A/D) and digital to analog (D/A) converters, digital I/O registers, 
and real-time clocks. It is connected to the VAX 11/780 through the 
UNIBUS Adapter (UBA) . 

The LPA11-K is a fast, flexible, and easy to use microprocessor 
subsystem that is designed for applications requiring concurrent data 
acquisition and data reduction at high rates. The LPA11-K allows 
aggregate analog input and output rates up to 150,000 samples per 
second. The maximum aggregate digital input and output rate is 15,000 
samples per second. 

Table 10-1 lists the useful minimum and maximum LPA11-K configurations 
supported by VAX/ VMS. 



10.1.1 LPA11-K Modes of Operation 

The LPA11-K operates in two distinct modes-* dedicated, and 
multirequest. 

In dedicated mode, only one user, that is, one request, can be active 
at a time, and only analog I/O data transfers are supported. Up to 
two A/D converters can be controlled simultaneously. One D/A 
converter can be controlled at a time. Sampling is initiated either 
by an overflow of the real-time clock or by an externally supplied 
signal. Dedicated mode provides sampling rates of up to 150,000 
samples per second. 
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Table 10-1 
Minimum and Maximum Configurations per LPA11-K 



Minimum 



1 - DDll-Cx or Dx Backplane 

1 - KW11-K Real Time Clock 

One of the following: 

AD11-K A/D Converter 

AA11-K D/A Converter 

DR11-K Digital I/O 
Register 



Maximum 



2 - DDll-Cx or Dx Backplanes 

1 - KW11-K Real Time Clock 

2 - AD11-K A/D Converters 

2 - AM11-K Multiplexers 
for AD11-K Converters 



1 - AA11-K D/A Converter 

5 - DR11-K Digital I/O 
Registers 



In multirequest mode, sampling from all 
10-1 is supported. The LPA11-K ope 
device; up to eight requests (from one 
simultaneously. The sampling rate for 
common real-time clock rate. Independen 
each user. Both the sampling rate and 
as part of each data transfer request, 
maximum aggregate sampling rate of 15,00 



the devices listed in Table 
rates like a multi-controller 
to eight users) can be active 
each user is a multiple of the 
t rates can be maintained for 
the device type are specified 
Multirequest mode provides a 
samples per second. 



10.1.2 Errors 

The LPA11-K returns three classes of errors: 

1. Errors associated with the issuance of a new LPA11-K command 
(SS$_DEVCMDERR) . 

2. Errors associated with an active data transfer request 
(SS$_DEVREQERR) . * 

3 ' IsS^CTRLERr" ""^ WhlCh aff6Ct aU LPA11 " K ^tivity 

Appendix A of the LPA11-K Laboratory Peripheral Accele rator User's 
Guide lists these three classes of errors and the specific error codes 
for each class. The LPA11-K aborts all active requests if any of the 
following conditions occur: 

• Power failure 

• Device timeout 

• Fatal error 

Power failure is reported to any active users when power is recovered. 
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Device timeouts are monitored only when a new command is issued. For 
data transfers, the time between buffer full interrupts is not 
defined. Thus, no timeout errors are reported on a buffer to buffer 
basis. 

If a required resource is not available to a process, an error message 
is returned immediately. The driver does not place the process in the 
resource wait mode. 



10.2 SUPPORTING SOFTWARE 

The LPA11-K is supported by a device driver, a high level language 
procedure library of support routines, and routines for microcode 
loading and device initialization. All data transfer algorithms for 
the laboratory data acquisition I/O devices are accomplished by the 
LPA11-K. The only purpose for the system software and support 
routines is to provide a control path for synchronizing the use of 
buffers, specifying requests, and starting and stopping requests. 

The LPA11-K driver and the associated I/O interface have the following 
features: 

• They permit multiple LPA11-K subsystems on a single UBA. 

• They operate as an integral part of the VAX/VMS operating 
system. 

• They can be loaded on an operating VAX/VMS system without 
relinking the executive. 

• They handle I/O requests, function dispatching, UBA map 
allocation, interrupts, and error reporting for multiple 
LPA11-K subsystems. 

• The LPA11-K functions as a multi-buffered device. Up to eight 
buffer areas can be defined per request. Up to eight requests 
can be handled simultaneously. Buffer areas can be reused 
after the data they contain is processed. 

• since the LPA11-K chains buffer areas automatically, a start 
data transfer request can transfer an infinite and continuous 
amount of data. 

• Multiple ASTs are dynamically queued by the driver to indicate 
when a buffer has been filled (the data is available for 
processing), or emptied (the buffer is available for new 
data) . 

The high level language support routines have the following features: 

• They translate arguments provided in the high level language 
calls into the format required for the Queue I/O interface. 

• They provide a buffer chaining capability for a multibuf fering 
environment by maintaining queues of used, in use, and 
available buffers. 

• They adhere to all VAX/VMS conventions for calling sequences, 
use of sharable resources, and re-entrancy. 

• They can be part of a resident global library, or be linked 
into a process image as needed. 
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The routines for microcode loading and device initialization have the 
following features: 

• They execute, as separate processes, images which issue I/O 
requests. These I/O requests initiate microcode image 
loading, start the LPA11-K subsystem, and automatically 
configure the peripheral devices on the LPA11-K internal I/O 
bus. ' 

• They can be executed by user or operator request. 

They can be executed at the request of other processes. 

They can be executed automatically when the system is 
initialized and on power recovery. 






Figure 10-1 shows the relationship of the supporting software to the 
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Figure 10-1 Relationship of Supporting Software to LPA11-K 



10.3 DEVICE INFORMATION 

Users can obtain information on all peripheral data acquisition 
irl^tfr °\ the L ? A11 " K eternal I/O bus by using the $GETCHN and 
SGETDEV system services (see Section 1.10). The LPAll-K-specif ic 
information is returned in the first three longwords of a 
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user-specified buffer, as shown in Figure 10-2 (Figure 1-9 shows the 
entire buffer) . 



31 



1615 



device characteristics 



type 



device-dependent characteristics 



87 



class 



Figure 10-2 LPA11-K Information 

The first longword contains device-independent information. The 
second and third longwords contain device-dependent data. 

Table 10-2 lists the device-independent characteristics returned in 
the first longword. 



Table 10-2 
Device- independent Characteristics 



Dynamic Bits! 
(Conditionally Set) 



DEV$M AVL 



Static Bits* 
(Always Set) 



DEV$M_IDV 
DEV$M_ODV 
DEV$M_RTM 
DEV$M SHR 



Meaning 



Device is online 
and available 



Input device 
Output device 
Real-time device 
Device is sharable 



1 Defined by the $DEVDEF macro. 

The second longword contains information on the device class and type. 
The device class for the LPAll-K is DC$ REALTIME and the device type 
is DT$ LPA11. The $LADEF macro defines tTiese values. Buffer size is 
not applicable to the LPAll-K; this word is 0. 

The third longword contains LPAll-K characteristics, that is, 
device-dependent data. LPAll-K characteristics are set by the set 
clock, initialize, and load microcode I/O functions to any one of, or 
a combination of, the values listed in Table 10-3. 
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Table 10-3 
Device-Dependent Characteristics 



Field 1 



LA$M_MCVALID 
LA$S_MC VALID 
LA$V MCVALID 



LA$V_MCTYPE 
LA$S MCTYPE 



LA$V_CONFIG 
LA$S CONFIG 



Meaning 



The load microcode I/O function (10$ LOADMCODE) 
was performed successfully. LA$M MCVALID is set 
by IO$_LOADMCODE. Each microword is verified by 
reading it back and comparing it with the specified 
value. LA$M_MCVALID is cleared if there is no 
match. 

The microcode type, set by the load microcode I/O 
function (IO$_LOADMCODE) , is one of the followinq 
values: ^ 



LA$K_MRMCODE = microcode type is 

mode 
LA$K_ADMCODE = microcode type is in 

mode 
LA$K_DAMCODE = microcode type is in 

mode 



in multirequest 
dedicated A/D 
dedicated D/A 



The bit positions, set by the initialize I/O 
function (IO$_INITIALIZE), for the peripheral data 
acquisition devices on the LPA11-K internal I/O bus 
are one or more of the following: 

LA$V_CLOCKA = Clock A 
LA$M_CL0CKA 

LA$V_CL0CKB = Clock B 
LA$M_CL0CKB 

LA$V_AD1 = A/D device 1 
LA$M AD1 



LA$V_AD2 
LA$M AD2 



A/D device 2 



LA$V_DA = D/A device 1 
LA$M_DA 

LA$V_DI01 = Digital I/O Buffer 1 
LA$M_DI01 

LA$V_DI02 = Digital I/O Buffer 2 
LA$M_DI02 

LA$V_DI03 = Digital I/O Buffer 3 
LA$M_DI03 

LA$V_DI04 = Digital I/O Buffer 4 
LA$M_DI04 

LA$V_DI05 = Digital I/O Buffer 5 
LA$M DI05 



Values defined by the $LADEF macro, 



(continued on next page) 
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Table 10-3 (Cont.) 
Device-Dependent characteristics 



Fieldl 



LA$V_RATE 
LA$S RATE 



LA$V_PRESET 
LA$S PRESET 



Meaning 



The Clock A rate, set by the set clock function 
(10$ SETCLOCK) , is one of the following values: 






= 


Stopped 


1 


= 


1 MHZ 


2 


= 


100 kHz 


3 


= 


10 kHz 


4 


= 


1 kHz 


5 


= 


100 Hz 


6 


= 


Schmidt trigger 


7 


= 


Line frequency 



The Clock A preset value set by the set clock 
function (IO$_SETCLOCK) . (The value is in the range 
through 65,535 - in two's complement form.) The 
clock rate divided by the clock preset value yields 
the clock overflow rate. 



Values defined by the $LADEF macro. 

10.4 LPA11-K I/O FUNCTION CODES 

The LPA11-K I/O functions are: 

1. Load microcode into the LPA11-K. 

2. Start the LPA11-K microprocessor. 

3. Initialize the LPA11-K subsystem. 

4. Set the LPA11-K real-time clock rate. 

5. Start a data transfer request. 

The Cancel I/O on Channel ($CANCEL) system service is used to abort 
data transfers. 

10.4.1 Load Microcode 

This I/O function resets the LPA11-K and loads an image of LPA11-K 
microcode. Physical I/O privilege is required. VAX/VMS defines a 
single function code: 

10$ LOADMCODE - load microcode 
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The load microcode function takes three device/function dependent 
arguments: 

• PI = the starting virtual address of the microcode image that 
is to be loaded into the LPA11-K 

• P2 = the number of bytes (usually 2048) that are to be loaded 

• P3 = the starting microprogram address (usually 0) in the 
LPA11-K that is to receive the microcode 

If any data transfer requests are active at the time a load microcode 
request is issued, the load request is rejected and SS$ DEVACTIVE is 
returned in the I/O status block. ™ ~~ 

Each microword is verified by comparing it with the specified value in 
memory. if all words match, that is, the microcode was loaded 
successfully, the driver sets the microcode valid bit (LA$V MCVALID) 
in the device-dependent characteristics longword (see Table 10-3) If 
there is no match, SS$_DATACHECK is returned in the I/O status block 
and LA$V_MCVALID is cleared to indicate that the microcode was not 
properly loaded. if the microcode was loaded successfully, the driver 
stores one of the microcode type values (LA$K MRCODE, LA$K ADCODE, or 
LA$K_DAMCODE) in the characteristics longword. ~ 

After a load microcode function is completed, the second word of the 
I/O status block contains the number of bytes loaded. 

In addition to SS$_DATACHECK, IO$_LOADMCODE can return SS$ DEVACTIVE 
in the I/O status block. ~ 



10.4.2 Start Microprocessor 

This I/O function resets the LPA11-K and starts (or restarts) the 
LPA11-K microprocessor. Physical I/O privilege is required. VAX/VMS 
defines a single function code: 

• IO$_STARTMPROC - start microprocessor 

This function code takes no device/function-dependent arguments. 

The start microprocessor function can return five error codes in the 
I/O status block: SS$_DEVACTIVE, SS$ MCNOTVALID, SS$ CTRLERR, 
SS$_POWERFAIL, and SS$ TIMEOUT (see Section To.6). 



10.4.3 Initialize LPA11-K 

This I/O function issues a subsystem initialize command to the 
LPA11-K. This command specifies LPA11-K laboratory I/O device 
addresses and other table information for the subsystem. It is issued 
only once after restarting the subsystem and before any other LPA11-K 
command is given. Physical I/O privilege is required. VAX/VMS 
defines a single function code: 

• IO$_INITIALIZE - initialize LPA11-K 
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The initialize LPA11-K function takes two device/function-dependent 
arguments: 

• PI = the starting, word-aligned, virtual address of the 
Initialize Command Table in the user process. This table is 
read once by the LPA11-K during the execution of the 
initialize command. See the LPA11-K Laboratory Peripheral 
Accelerator User's Guide for additional information. 



• 



P2 = length of the initialize command buffer (always 278 
bytes) 



If the, initialize function is completed successfully, the appropriate 
device configuration values are set in the device-dependent 
characteristics longword (see Table 10-3). 

The initialize function can return ten error codes in the I/O status 
block: SS$ IVMODE, SS$ INCLENGTH, SS$_BUFNOTALIGN , SS$_CTRLERR, 
SS$ DEVCMDERR7 SS$_CANCEL, SS$_INSFMAPREG, SS$_MCNOTVALID, 
SS$J?OWERFAIL, and SS$_TIMEOUT (see Section 10.6). 

If a device specified in the Initialize Command Table is not in the 
LPA11-K configuration, an error condition (SS$_DEVCMDERR) occurs and 
the address of the first device not found is returned in the LPA11-K 
maintenance status register (see Section 10.6). A program can use 
this characteristic to poll the LPA11-K and determine the current 
device configuration. 



10.4.4 Set Clock 

This virtual function issues a clock control command to the LPA11-K. 
The clock control command specifies information necessary to start, 
stop, or change the sample rate at which the real-time clock runs on 
the LPA11-K subsystem. 

If the LPA11-K has more than one user, caution should be exercised 
when the clock rate is changed. In multirequest mode, a change in the 
clock rate will affect all users. 

VAX/VMS defines a single function code: 

• IO$_SETCLOCK - set clock 

The set clock function takes three device/function-dependent 
arguments: 

• P2 = mode of operation. VAX/VMS defines the following clock 
start mode word (hexadecimal) values: 

1 = KW11-K Clock A 
11 = KWll-K Clock B 

• P3 = clock control and status. VAX/VMS defines the following 
clock status word (hexadecimal) values: 

= stop clock 
143 = 1 MHz clock rate 
145 = 100 kHz clock rate 
147 = 10 kHz clock rate 
149 = 1 kHz clock rate 
14B = 100 Hz clock rate 
14D = clock rate is Schmidt trigger 1 
14F = clock rate is line frequency 
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• P4 = the two's complement of the real-time clock preset value 
The range is 16 bits for the KW11-K Clock A and 8 bits for the 
KW11-K Clock B. 

The LPA11-K L aboratory Peripheral Accelerator User's Guide describes 
the clock start mode word and the clock status word in greater detail. 



If the set clock function is completed successfully for Clock A, the 
clock rate and preset values are stored 
characteristics longword (see Table 10-3) . 



in the device-dependent 



The set clock function can return six error codes in the I/O status 
block: SS$_CTRLERR, SS$_DEVCMDERR, SS$ CANCEL, SS$ MCNOTVALID. 
SS$_POWERFAIL, and SS$ TIMEOUT (see Section 10.6), 



10.4.5 Start Data Transfer Request 

This virtual I/O function issues a Data Transfer Start command that 
specifies the buffer addresses, sample mode, and sample parameters 
used by the LPA11-K. This information is passed to the Data Transfer 
Command Table. VAX/VMS defines a single function code: 

• IO$_STARTDATA - start data transfer request 

The start data transfer request function takes one function modifier: 

• IO$M_SETEVF - set event flag 

The start data transfer request function takes four 
device/function-dependent arguments: 

• PI = the starting virtual address of the Data Transfer Command 
Table in the user's process 

• P2 = the length in bytes (always 40) of the Data Transfer 
Command Table 

• P3 = the AST address of the normal buffer completion AST 
routine (optional) 

• P4 = the AST address of the buffer overrun completion AST 
routine (optional). Only used when the buffer overrun bit 
(LA$M___BFROVRN) is set, that is, a buffer overrun condition is 
classified as a non-fatal error. 



A buffer overrun condition is not 
condition. The LPA11-K fetches data 
If data cannot be fetched quickly eno 
too much UNIBUS activity, a data un 
cannot be stored quickly enough, a 
After each buffer has been filled or 
index number of the next buffer to pr 
(USW) . (See Section 2.5 of the 
Accelerator User's Guide ) . A buffer 
LPA11-K fills or empties buffers fa 
can supply new buffers. For example, 
the sampling rate is too high, 
system load is too heavy. 



the same as a data overrun 

from, or stores data in, memory. 

ugh, for example, when there is 

derrun condition occurs. If data 

data overrun condition occurs. 

emptied, the LPA11-K obtains the 

ocess from the User Status Word 

LPA11-K Laboratory Peripheral 

overrun condition occurs if the 

ster than the application program 

buffer overrun can occur when 

the buffers are too small, or the 



The LPA11-K driver accesses the ten-longword Data Transfer Command 
Table, shown in Figure 10-3, when the Data Transfer Start command is 
processed. After the command is accepted and data transfers have 
begun, the driver makes no further access to the table. 
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31 24 23 16 15 8 7 
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Figure 10-3 Data Transfer Command Table 



In the first longword of the Data Transfer Command Table, the first 
two bytes contain the LPA11-K start data transfer request mode word. 
(Section 3.4.1 of the LPA11-K Laboratory Peripheral Accelerator User's 
Guide describes the functions of this word.) ~ 

The third byte contains the number (0-7) of the highest buffer 

available and the buffer overrun flag bit (bit 23; values: 

LA$M BFROVRN and LA$V_BFROVRN) . If this bit is set, a buffer overrun 
condTtion is a non-fatal error. 

The second longword contains the User Status Word address (see Section 
3.4.3 of the LPA11-K Laboratory Peripheral Accelerator User's Guide ). 
This virtual address points to a two-byte area Fn tHe user process 
space, and must be word-aligned. 



The third longword contains the size (in 
area. The virtual address in the fo 
address of this area. This address mus 
overall buffer area contains a specified 
of the highest available buffer specifie 
one) . individual buffers are subjec 
multirequest mode the length must be in 
dedicated mode the length must be in 
data buffers are virtually contiguous fo 



bytes) of the overall buffer 
urth longword is the beginning 
t be longword-aligned. The 

number of buffers (the number 
d in the first longword plus 
t to length restrictions: in 
multiples of two bytes; in 

multiples of four bytes. All 
r each data transfer request. 
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The fifth and sixth longwords contain the Random Channel List (RCL) 
length and address, respectively. The RCL address must be 
word-aligned. The last word in the RCL must have bit 15 set. (See 
Section 3.4.6 of the LPAll-K Laboratory Peripheral Acceler ator User's 
Guide for additional information on the RCL.) ~~ 

The seventh through tenth longwords contain LPAll-K-specif ic sample 
parameters. The driver passes these parameters directly to the 
LPA11-K. (See Sections 3.4.7 through 3.4.12 of the LPA11-K Laborator y 
Peripheral Accelerator User's Guide for a detailed description of 
their functions.) ~ ~ 

The start data transfer request function can return 15 error codes in 
the I/O status block: SS$_INCLENGTH, SS$ BUFNOTALIGN, SS$ DEVCMDERR, 
SS$_CTRLERR, SS$_DEVREQERR, SS$_ABORT, ~ SS$ CANCEL, SS$ EXQUOTA, 
SS$_INSPBUFDP, SS$_INSFMAPREG, SS$ INSFMEM, SS$ MCNOTVALID, 
SS$_PARITY, SS$_POWERFAIL, and SS$_TIMEOUT~~(see Section 10T6) . 

Data buffers are chained and reused as the LPA11-K and the user 
process dispose of the data. As each buffer is filled or emptied, the 
LPAll-K driver notifies the application process by either setting the 
event flag specified by the QIO request efn argument or queueing an 
AST. Since buffer use is a continuing process, the event flag is set 
or the AST is queued a number of times. The user process must clear 
the event flag (or receive the AST), process the data, and specify the 
next buffer for the LPAll-K to use. 

If the set event flag function modifier (IO$M_SETEVF) is specified, 
the event flag is set repeatedly: when the data transfer request is 
started, on each buffer completion, and when the request completes. 
If IO$M_SETEVF is not specified, the event flag is set only when the 
request completes. 

ASTs are preferred over event flags for synchronizing a program with 
the LPAll-K because AST delivery is a queued process while setting of 
event flags is not. if only event flags are used, it is possible to 
lose buffer status. 

Three AST addresses can be specified. For normal data buffer 
transactions the AST address specified in the P3 argument is used. If 
the buffer overrun bit in the Data Transfer Command Table is set and 
an overrun condition occurs, the AST address specified in the P4 
argument is used. The AST address specified in the astadr argument of 
the QIO request is used when the entire data transfer request is 
completed. The astprm argument specified in the QIO request is passed 
to all three AST routines. 

* 

If insufficient dynamic memory is available to allocate an AST block, 
an error (SS$_INSFMEM) is returned. if the user does not have 
sufficient AST quota remaining to allocate an AST block, an error 
(SS$_EXQUOTA) is returned. In either case, the request is stopped. 
Normally, there are, never more than three outstanding ASTs per LPAll-K 
request. 



10.4.6 LPAll-K Data Transfer Stop Command 

The Cancel I/O on Channel ($CANCEL) system service is used to abort 
data transfers for a particular process. When the LPAll-K driver 
receives a $CANCEL request, a Data Transfer Stop command is issued to 
the LPAll-K. 
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The normal way to stop a data transfer is to set bit 14 of the User 

Status Word. If this bit is set, the transfer stops at the end of the 

next buffer transaction (see Section 2.5 of the LPA11-K Laboratory 
Peripheral Accelerator User's Guide) . 



10.5 HIGH LEVEL LANGUAGE INTERFACE 



VAX/VMS supports several 
access to the LPA11-K. Th 
for VAX- 11 FORTRAN IV-PLUS 
standard VAX/VMS argument 
(Optionally, VAX- 11 MACRO 
through the use of the d 
in Section 10.4.) Users of 
proper subroutine or pr 
procedure call is not the 
a MACRO interface. 



program-callable procedures that provide 
e formats of these calls are documented here 

users. VAX-11 MACRO users must set up a 

block and issue the standard procedure CALL. 

users can, access the LPAll-K directly 

evice-specif ic Queue I/O functions described 

other high level languages must specify the 
ocedure invocation. If the subroutine or 
standard linkage, some languages may require 



10.5.1 High Level Language Support Routines 

VAX/VMS provides 20 high level language procedures for the LPAll-K. 
These procedures are divided into four classes. Table 10-4 lists the 
VAX-11 procedures for the LPAll-K. 



Table 10-4 
VAX-11 Procedures for the LPAll-K 



Class 



Sweep Control 



Clock control 



Data Buffer 
Control 



Subroutine 



Miscellaneous 



LPA$ADSWP 
LPA$DASWP 
LPA$DISWP 
LPA$DOSWP 
LPA$LAMSKS 

LPA$SETADC 
LPA$SETIBP 
LPA$STPSWP 

LPA$CLOCKA 
LPA$CLOCKB 
LPA$XRATE 

LPA$IBFSTS 
LPA$IGTBUF 
LPA$INXTBF 
LPA$IWTBUF 
LPA$RLSBUF 
LPA$RMVBUF 

LPA$CVADF 
LPA$FLT16 

LPA$LOADMC 



Function 



Start A/D converter sweep 

Start D/A converter sweep 

Start digital input sweep 

Start digital output sweep 

Specify LPAll-K controller and 

digital mask words 

Specify channel select parameters 

Specify buffer parameters 

Stop sweep 

Set Clock A rate 
Set Clock B rate 
Compute clock rate and preset value 

Return buffer status 

Return next available buffer 

Alter buffer order 

Return next buffer or wait 

Release buffer to LPAll-K 

Remove buffer from device queue 

Convert A/D input to floating point 

Convert unsigned integer to floating 

point 

Load microcode and initialize 

LPAll-K 
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10.5.1.1 Buffer Queue Control - This section is provided for 
informational purposes only. Normally, the user does not need to be 
concerned with the details of buffer queues. 

Buffer queue control for data transfers by LPA11-K subroutines 
involves the use of three queues: 

• Device queue (DVQ) 

• User queue (USQ) 

• In-use queue (IUQ) 

Each data transfer request can specify from one to eight data buffer 
areas. The user specifies these buffers by address. During execution 
of the request, the LPA11-K assigns an index from to 7 when a buffer 
is referenced. 

The DVQ contains the indices of all the buffers that the user has 
released, that is, made available to be filled or emptied by the 
LPA11-K. For output functions (D/A and digital output), these buffers 
contain data to be output by the LPA11-K. For input functions (A/D 
and digital input), these buffers are empty and waiting to be filled 
by the LPA11-K. 

The USQ contains the indices of all buffers that are waiting to be 
returned to the user. The LPA$IWTBUF and LPA$IGTBUF calls are used to 
return the index of the next buffer in the USQ. For output functions 
(D/A and digital output) , these buffers are empty and waiting to be 
filled by the application program. For input functions (A/D and 
digital input), these buffers contain data to be processed by the 
application program. 

The IUQ contains the indices of all buffers that are currently being 
processed by the LPA11-K. Normally, the IUQ contains the indices of 
two buffers: 

• The buffer currently being filled or emptied by the LPA11-K 

• The next buffer to be filled or emptied by the LPA11-K. This 
is the buffer specified by the next buffer index field in the 
User Status Word. 

Because the LPA11-K driver requires that at least one buffer be ready 
when the input or output sweep is started, the user must call 
LPA$RLSBUF before the sweep is initiated. 

Figure 10-4 shows the flow between the buffer queues. 

10.5.1.2 Subroutine Argument Usage - Table 10-5 describes the general 
use of the subroutine arguments. The subroutine descriptions in the 
following sections contain additional information on argument usage 
The IBUF, BUF, and ICHN (Random Channel List address) arguments must 
be aligned on specific boundaries. (The VAX-11 FORTRAN- I V-PLUS User' s 
Guide describes the alignment of FORTRAN arguments.) 
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Figure 10-4 Buffer Queue Control 

Table 10-5 
Subroutine Argument Usage 



Argument 



Meaning 



IBUF 



A 50-longword array initialized by the LPA$SETIBF 
subroutine. IBUF is the impure area used by the 
buffer management subroutines. A unique IBUF array 
is required for each simultaneously active request. 
IBUF must be longword-aligned. 

The first quadword in the IBUF array is an I/O status 
block (IOSB) for high level language subroutines. 
The LPA$IGTBUF and LPA$IWTBUF subroutines fill this 
quadword with the current and completion status (see 
Section 10.6) . 



(continued on next page) 
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Table 10-5 (Cont.) 
Subroutine Argument Usage 



Argument 



Meaning 



LBUF 



NBUF 



MODE 



IRATE 



IPRSET 



DWELL 



Specifies the size o 
be even for dedicat 
the same size. The 
multirequest mode 
dedicated mode data 
the assigned buffer 
Thus, the maximum si 
limited to 32,768 
The LBUF argument le 



f each data buffer in words (must 
ed mode sweeps) . All buffers are 
minimum value for LBUF is 1 for 
data transfers and 258 for 
transfers. The aggregate size of 
s must be less that 32,768 words, 
ze of each buffer (in words) is 
divided by the number of buffers, 
ngth is one word. 



Specifies the number of times the buffers are to be 
filled during the life of the request. If 
(default) is specified, sampling is indefinite and 
must be stopped with the LPA$STPSWP subroutine. The 
NBUF argument length is one longword. 

Specifies sampling options. MODE bit values are 
listed in the appropriate subroutine descriptions. 
The default is 0. MODE values can be added to 
specify several options. No options are mutually 
exclusive although not all bits may be applicable at 
the same time. The MODE argument length is one word. 

Specifies the clock rate: 

= Clock B overflow or no rate 
1=1 MHz 

2 = 100 kHz 

3 = 10 kHz 
4=1 kHz 

5 = 100 Hz 

6 = Schmidt trigget 

7 = Line frequency 

The IRATE argument length is one longword. 

Specifies the hardware clock preset value. This 
value is the two's complement of the desired number 
of clock ticks between clock interrupts. (The 
maximum value is the two's complement of 65,536.) 
IPRSET can be computed by the LPA$XRATE subroutine. 
The IPRSET argument length is one word. 

Specifies the number of hardware' clock overflows 
between sample sequences in multirequest mode. For 
example, if DWELL is 20 and NCHN is 3, then after 20 
clock bverflows one channel is sampled on each of the 
next three successive overflows; no sampling occurs 
for the next 20 clock overflows. This allows 
different users to use different sample rates with 
the same hardware clock overflow fate. In dedicated 
mode, the hardware clock overflow rate controls 
sampling and DWELL is not accessed. Default for 
DWELL is 1» The DWELL argument length is one word. 



(continued on next page) 
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Table 10-5 (Cont.) 
Subroutine Argument Usage 



Argument 



Meaning 



IEFN 



LDELAY 



ICHN 



Specifies the event flag number or completion routine 
address. The selected event flag is set at the end 
of each buffer transaction. If IEFN is (default) , 
event flag 22 is used. 

IEFN can also specify the address of a completion 
routine. This routine is called by the buffer 
management routine when a buffer is available and 
when the request is terminated, either successfully 
or with an error. The standard VAX/VMS calling and 
return sequences are used. The completion routine is 
called from an AST routine and is therefore at AST 
level. 

If IEFN specifies the address of a completion 
routine, the program must call LPA$IGTBUF to obtain 
the next buffer. If IEFN specifies an event flag, 
the program must call LPA$IWTBUF to obtain the next 
buffer and must use the %VAL operator: 



,%VAL(3) , 
,BFRFULL, 



(Event flag 3) 

(Address of completion 
routine) 



The IEFN argument length is one longword. 

If multiple sweeps are initiated, they must use 
different event flags (the software does not enforce 
this policy) . 

Event flag 23 is reserved for use by the LPA$CLOCKA 
and LPA$CLOCKB subroutines. if either of these 
subroutines is included in the user program, event 
flag 23 cannot be used. Also, if IEFN is defaulted, 
event flag 22 cannot be used in the user program. 

Specifies the delay, in IRATE units, from the start 
event until the first sample is taken. The maximum 
value is 65,536; default is 1. The* LDELAY argument" 
length is one. word. The LPAH-K supports the LDELAY 
argument in- multirequest mode only. 



Specifies tk& number of the - first I/O ch 
sampled. Default is channel 0. The 
length is one byte.- The channel number 
same as the channel assigned to the 
$ASSIGN Sygtem service (see Section 
LPA11*K Uses" the channel number to 
multiplexer address of an A/B, D/A, or 
device ort the LPA11-K internal I/O bus. 



annel to be 

I-CHN argument 

is not the 

device by the 

1.8.1), The 

specify the 

digital I/O 



(continued on next page) 
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Table 10-5 (Cont.) 
Subroutine Argument Usage 



Argument 



Meaning 



NCHN 



IND 



Specifies the number of I/O device 
in a sample sequence. Default 
argument is 1, the single channel 
mode word of the start Request Des 
when the sweep is started. The 
information needed by the LPA11 
(see the LPA11-K Laboratory Peri 



channels to sample 

is 1. If the NCHN 

bit is set in the 

criptor Array (RDA) 

RDA contains the 

K for each command 

pheral Accelerator 



User's Guide) . The NCHN argument length is one word. 



Receives the VAX/VMS success or failure code of 
call. The IND argument length is one longword. 



the 



10.5.2 LPA$ADSWP - Initiate Synchronous A/D Sampling Sweep 

The LPA$ADSWP subroutine initiates A/D sampling through an AD11-K. 

The format of the LPA$ADSWP call is as follows: 

CALL LPA$ADSWP (IBUF,LBUF, [NBUF] , [MODE] , [DWELL] , [IEFN] , [LDELAY] , 
[ICHN] , [NCHN] , [IND]) 

Arguments are as described in Section 10.5.1.2, with the following 
additions: 



MODE Specifies sampling options. VAX/VMS 
following sampling option values: 



defines the 



Value Meaning 

32 Parallel A/D conversion sample algorithm 
is used if dual A/D converters are 
specified (value = 8192) . Absence of this 
bit implies the serial A/D conversion 
sample algorithm. 

64 Multirequest mode request. Absence of 
this bit implies a dedicated mode request. 

512 External trigger (Schmidt trigger 1) . 
Dedicated mode only. (The LPA11-K 
Laboratory Peripheral Accelerator User's 
Guide describes the use of an external 
trigger. ) 

1024 Time stamped sampling with Clock B. The 
double word consists of one data word 
followed by the value of the LPAll-K's 
internal 16-bit counter at the time of the 
sample (see Section 2.4.3 in the LPA11-K 
Laboratory Peripheral Accelerator User's 
Guide ) . Multirequest mode only. 
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Value Meaning 

2048 Event marking. Multirequest mode only. 
(The LPA11-K Laboratory Peripheral 
Accelerator User's Guide describes event 
marking.) 

4096 Start method. If selected, digital input 
start. if not selected, immediate start. 
Multirequest mode only. 

8192 Dual A/D converters are to be used. 
Dedicated mode only. 

16384 Buffer overrun is a non-fatal error. The 
LPA11-K will automatically default to fill 
buffer if a buffer overrun condition 
occurs. 

If MODE is defaulted, A/D sampling starts immediately 
with absolute channel addressing in dedicated mode. 
The LPA11-K does not support delays in dedicated mode. 

IND Returns the success or failure status: 

= Error in call. Possible causes are: LPA$SETIBF 
was not previously called; LPA$RLSBUF was not 
previously called; size of data buffers disagrees with 
the size computed by the LPA$SETIBF call. 

1 = successful sweep started 
nnn = VAX/VMS status code 



10.5.3 LPA$DASWP - Initiate Synchronous D/A Sweep 

The LPA$DASWP subroutine initiates D/A output to an AA11-K. 

The format for the LPA$DASWP call is as follows: 

CALL LPA$DASWP (IBUF,LBUF, [NBUF] , [MODE] , [DWELL] , [IEFN] , [LDELAY] , 
[ICHN] , [NCHN] , [IND]) 

Arguments are as described in Section 10.5.1.2, with the following 
additions : 

MODE Specifies the sampling options. VAX/VMS defines the 
following start criteria values: 

Value Meaning 

Immediate start. This is the default 
value for MODE. 

64 Multirequest mode. If not selected, this 
request is for dedicated mode. 

4096 Start method. If selected, digital input 
start. If not selected, immediate start. 
Multirequest mode only. 
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Value Meaning 

16384 Buffer overrun is a non-fatal error. The 
LPA11-K will automatically default to 
empty buffer if a buffer overrun 
condition occurs. 

IND Returns the success or failure status: 

= Error in call. Possible causes are: LPA$SETIBF 
was not previously called; LPA$RLSBUF was not 
previously called; size of data buffers disagrees with 
the size computed by the LPA$SETIBF call. 

1 = successful sweep started 
nnn = VAX/VMS status code 



10.5.4 LPA$DISWP - Initiate Synchronous Digital Input Sweep 

The LPA$DISWP subroutine initiates digital input through a DR11-K. 
LPA$DISWP is applicable in multirequest mode only. 

The format of the LPA$DISWP call is as follows: 

CALL LPA$DISWP (IBUF,LBUF, [NBUF] , [MODE] , [DWELL] , [IEFN] , [LDELAY] , 
[ICHN], [NCHN] , [IND]) 

Arguments are as described in Section 10.5.1.2, with the following 
additions: 

MODE Specifies sampling options. VAX/VMS defines the 
following sampling option values: 

Value Meaning 

Immediate start. This is the default 
value for MODE. 

512 External trigger for DR11-K. (The LPA11-K 
Laboratory Peripheral Accelerator User's 
Guide describes the use of an" external 
trigger.) 

1024 Time stamped sampling with Clock B. The 
double word consists of one data word 
followed by the value of the internal 
LPA11-K, 16-bit, counter at the time of 
the sample (see Section 2.4.3 in the 
LPA11-K Laboratory Peripheral Accelerator 
User's Guide ) . 

2048 Event marking. (The LPA11-K Laboratory 
Peripheral Accelerator User's Guide 
describes event marking.) 

4096 Start method. If selected, digital input 
start. If not selected, immediate start. 

16384 Buffer overrun is a non-fatal error. The 
LPAll-K will automatically default to fill 
buffer if a buffer overrun condition 
occurs. 
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IND Returns the success or failure status: 

= Error in call. Possible causes are: LPA$SETIBF 
was not previously called; LPA$RLSBUF was not 
previously called; size of data buffers disagrees with 
the size computed by the LPA$SETIBF call. 

1 = successful sweep started 
nnn = VAX/VMS status code 



10.5.5 LPA$D0SWP - Initiate Synchronous Digital Output Sweep 

The LPA$D0SWP subroutine initiates digital output through a DR11-K. 
LPA$D0SWP is applicable in multirequest mode only. 

The format of the LPA$D0SWP call is as follows: 

CALL LPA$D0SWP (IBUF,LBUF, [NBUF] , [MODE] , [DWELL] , [IEFN] , [LDELAY] , 
[ICHN] , [NCHN] , [IND]) 

Arguments are as described in Section 10.5.1.2, with the following 
additions: 

MODE Specifies the sampling options. VAX/VMS defines the 
following values: 

Value Meaning 

Immediate start. This is the default 
value for MODE. 

512 External trigger for DR11-K (The LPA11-K 
Laboratory Peripheral Accelerator User's 
Guide describes the use of an external 
trigger.) 

4096 start method. If selected, digital input 
start. If not selected, immediate start. 

16384 Buffer overrun is a non-fatal error. The 
LPA11-K will automatically default to 
empty buffer if a buffer overrun 
condition occurs. 

IND Returns the success or failure status: 

= Error in call. Possible causes are: LPA$SETIBF 
was not previously called; LPA$RLSBUF was not 
previously called; size of data buffers disagrees with 
the size computed by the LPA$SETIBF call. 

1 = successful sweep started 
nnn = VAX/VMS status code 
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10.5.6 LPA$LAMSKS - Set LPA11-K Masks and NUM Buffer 

The LPA$LAMSKS subroutine initializes a user buffer which contains a 
number to append to the logical name LPA11$, a digital start word 
mask, an event mark mask, and channel numbers for the two masks. 

LPA$LAMSKS must be called: 

• By users who intend to use digital input starting or event 
marking 

• By users who do not want to use the default of LAAO assigned 
to LPA11$0 

• If multiple LPAll-Ks are used 

The format of the LPA$LAMSKS call is as follows: 

CALL LPA$LAMSKS (LAMSKB, [NUM] , [IUNIT] , [IDSC] , [IEMC] , [IDSW] , 
[IEMW] , [IND]) 

Argument descriptions are as follows: 

LAMSKB Specifies a 4-word array 

NUM Specifies the number appended to LPA11$. The sweep 

is started on the LPA11-K assigned to LPAll$num. 

IUNIT Not used. This argument is present for 
compatibility only. 

IDSC Specifies the digital START word channel. Range is 

to 4. The IDSC argument length is one byte. 

IEMC Specifies the event MARK word channel. Range is 

to 4. The IEMC argument length is one byte. 

IDSW Specifies the digital START word mask. The IDSW 

argument length is one word. 

IEMW Specifies the event MARK word mask. The IEMW 

argument length is one word. 

IND Always equal to 1 (success) . This argument is 

present for compatibility only. 



10.5.7 LPA$SETADC - Set Channel Information For Sweeps 

The LPA$SETADC subroutine establishes channel start and increment 
information for the sweep control subroutines (see Table 10-4). The 
LPA$SETIBF subroutine must be called to initialize IBUF before 
LPA$SETADC is called. 

The two formats for the LPA$SETADC call are as follows: 

CALL LPA$SETADC ( IBUF, [IFLAG] ,[ ICHN] , [NCHN] , [INC] , [IND] ) 

or, 

IND=LPA$SETADC (IBUF, [IFLAG] , [ICHN] , [NCHN] , [INC] ) 
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Argument descriptions are as follows: 



IND 



IBUF 
I FLAG 

ICHN 



NCHN 



INC 



Returns the success or failure status: 

= LPA$SETIBF was not called prior to the 
LPA$SETADC call 

1 = LPA$SETADC call successful 

The IBUF array specified in the LPA$SETIBF call 

Reserved. This argument is present for 
compatibility only. 

Specifies the first channel number. Range is to 
255; default is 0. The ICHN argument length is 
one longword. 

If INC = 0, ICHN is the address of a Random 
Channel List. This address must be word-aligned. 

Specifies the number of samples taken per sample 
sequence. Default is 1. 

Specifies the channel increment. Default is 1. 
If INC is 0, ICHN is the address of a Random 
Channel' List. The INC argument length is one 
longword. 



10.5.8 LPA$SETIBF - Set IBUF Array For Sweeps 

The LPA$SETIBF subroutine initializes the IBUF array for use with the 
LPA$ADSWP, LPA$DISWP, LPA$DOSWP, LPA$DASWP, LPA$STPSWP, LPA$IWTBUF, 
LPA$IGTBUF, LPA$IBFSTS, LPA$RLSBUF, LPA$INXTBF, LPA$SETADC, and 
LPA$RMVBUF subroutines. 

The format of the LPA$SETIBF call is as follows: 

CALL LPA$SETIBF (IBUF, [ IND] , [LAMSKB] ,BUF0 , [BUF1 ,... ,BUF7] ) 

Arguments are as described in Section 10.5.1.2, with the following 
additions: 



IBUF 



IND 



Specifies a 50-longword array- that is initialized 

by this subroutine. IBUF must be 

lbngword-aligned. (See Table 10-5 for additional 
information on IBUF.) 

Returns the success or failure status: 

= Error in call. Possible causes are: 
incorrect number of arguments; IBUF array not 
longword-aligned; buffer addresses not 
equidistant. 

1 = IBUF initialized successfully 
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LAMSKB Specifies the name of a 4-word array. This array 
allows the use of multiple LPAll-Ks within the 
same program because the argument used to start 
the sweep is specified by the LPA$LAMSKS call. 
(See Section 10.5.6 for a description of the 
LPA$LAMSKS subroutine.) 

BUFO, etc. Specify the names of the buffers. A maximum of 
eight buffers can be specified. At least two 
buffers must be specified to provide continuous 
sampling. The LPA11-K driver requires that all 
buffers be contiguous. To ensure this, LPA$SETIBF 
verifies that all buffer addresses are 
equidistant. Buffers must be longword-aligned. 



10.5.9 LPA$STPSWP - Stop In-progress Sweep 

The LPA$STPSWP subroutine allows a user to stop a sweep that is in 
progress. 

The format of the LPA$STPSWP call is as follows: 
CALL LPA$STPSWP ( IBUF, [ IWHEN] , [ IND] ) 

Arguments are as described in Section 10.5.1.2, with the following 
additions: 

THE IBUF array specified in the LPA$ADSWP, 
LPA$DASWP, LPA$DISWP, or LPA$DOSWP call that 
initiated the sweep. 

Specifies when to stop the sweep. VAX/VMS defines 
the following values: 

= Abort sweep immediately. Uses the $CANCEL 
system service. This is the default sweep stop. 

1 = Stop sweep when the current buffer transaction 
is completed. (This is the preferred way to stop 
requests. ) 

Receives a success or failure code in the standard 
VAX/VMS format: 



IBUF 



IWHEN 



IND 



1 = Success 



nnn = VAX/VMS error code issued by the $CANCEL 
system service 



1Q.5.10 LPA$CLOCKA - Clock A Control 

The LPA$CLOCKA subroutine sets the clock rate for Clock A. 
The format of the LPA$CLOCKA call is as follows: 
CALL LPA$CLOCKA (IRATE , IPRSET, [IND] , [NUM] ) 
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Arguments are as described in Section 10.5.1.2, with the following 
additions: 



IRATE 



of the following 



IPRSET 



IND 



NUM 



Specifies the clock rate. One 
values must be specified: 

= Clock B overflow or no rate 
1=1 MHz 

2 = 100 kHz 

3 = 10 kHZ 
4=1 kHz 

5 = 100 Hz 

6 = Schmidt trigger 1 

7 = Line frequency 

Specifies the clock preset value. Maximum of 16 
bijbs. The LPA$XRATE subroutine can be used to 
calculate this value. The clock rate divided by 
the clock preset value yields the clock overflow 
rate. 

Receives a success or failure code as follows: 

1 = Clock A set successfully 

nnn = VAX/VMS error code indicating an I/O error 

Specifies the number to be appended to the logical 
name LPA11$. If defaulted, NUM is 0. This 
subroutine sets Clock A on the LPA11-K assigned to 
LPAll$num. 



10.5.11 LPA$CLOCKB - Clock B Control 

The LPA$CLOCKB subroutine provides the user with control of the KW11-K 
Clock B. 

The format of the LPA$CLOCKB call is as follows: 

CALL LPA$CLOCKB ([ IRATE] , IPRSET, MODE ,[ IND] , [NUM] ) 

Arguments are as described in Section 10.5.1.2, with the following 
additions : 



IRATE 



One of the following 



Specifies the clock rate, 
values must be specified: 

= Stops Clock B 
1=1 MHz 

2 = 100 kHz 

3 = 10 kHz 

4 = 1 kHz 

5 = 100 Hz 

6 = Schmidt trigger 3 

7 = Line frequency 

If IRATE is (default), the clock is stopped and 
the IPRSET and MODE arguments are ignored. 
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IPRSET 



MODE 



IND 



NUM 



Specifies the preset value by which the clock rate 

is divided to yield the overflow rate. Maximum of 

8 bits. Overflow events can be used to drive 

Clock A. The LPA$XRATE subroutine can be used to 
calculate the IPRSET value. 

Specifies options. VAX/VMS defines the following 
values: 

1 = Clock B operates in non-interrupt mode. 

2 = The feed B to A bit in the Clock B status 
register will be set (see Section 3.3 of the 
LPA11-K Laboratory Peripheral Accelerator User's 
Guide ) . 

Receives a success or failure code as follows: 

1 = Clock B set successfully 

nnn = VAX/VMS error code indicating an I/O error 

Specifies the number to be appended to the logical 
name LPA11$. If defaulted, NUM is 0. This 
subroutine sets Clock B on the LPA11-K assigned to 
LPAll$num. 



10.5.12 LPA$XRATE - Compute Clock Rate and Preset Value 

The LPA$XRATE subroutine computes the clock rate and preset value for 
the LPA$CLOCKA and LPA$CLOCKB subroutines using the specified 
inter-sample interval (AINTRVL) . 

The two formats for the LPA$XRATE call are as follows: 

CALL LPA$XRATE (AINTRVL, IRATE , IPRSET, IFLAG) 

or, 

ACTUAL=LPA$XRATE (AINTRVL, IRATE, IPRSET, IFLAG) 

Arguments are as described in Section 10.5.1.2, with the following 
additions: 



AINTRVL 

IRATE 

IPRSET 
IFLAG 



Specifies the inter-sample time selected by the 
user. The time is expressed in decimal seconds. 
Data type is floating point. 

Receives the computed clock rate as a value from 1 
to 5. 

Receives the computed clock preset value. 

If the computation is for Clock A, IFLAG is 0; if 
for Clock B, IFLAG is not (the maximum preset 
value is 255) . The IFLAG argument length is one 
byte. 
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ACTUAL 



Receives the actual inter-sample time if called as 
a function. Data type is floating point. If 
there are truncation and roundoff errors, this 
time can be different from the specified 
inter-sample time. Note that when LPA$XRATE is 
called from VAX-11 FORTRAN IV-PLUS programs as a 
function, it must be explicitly declared a real 
function. Otherwise, LPA$XRATE defaults to an 
integer function. 



If AINTRVL is too large or too small to be achieved, 
ACTUAL are returned to 0. 



both IRATE and 



10.5.13 LPA$IBFSTS - Return Buffer Status 

The LPA$IBFSTS subroutine returns information on the buffers used in a 
sweep. 

The format of the LPA$IBFSTS call is as follows: 

CALL LPA$IBFSTS (IBUF,ISTAT) 
Argument descriptions are as follows: 



IBUF 



ISTAT 



The IBUF array specified in 
initiated the sweep. 



the call 



that 



Specifies a longword array with as many elements 
as there are buffers involved in the sweep 
(maximum of eight) . LPA$IBFSTS fills each array 
element with the status of the corresponding 
buffer : 



+2 = Buffer in device queue, 
called for this buffer. 



LPA$RLSBUF has been 



+1 = Buffer in user queue. The LPA11-K has filled 
(data input) or emptied (data output) this buffer. 

= Buffer is not in any queue. 

-fl = Buffer is in the in-use queue, that is, it is 
either being filled or emptied or is the next to 
be filled or emptied by the LPA11-K. 



10.5.14 LPA$IGTBUF - Return Buffer Number 

The LPA$IGTBUF subroutine returns the number of the next buffer to be 
processed by the application program, that is, the buffer at the head 
of the user queue (see Figure 10-4) . LPA$IGTBUF should be called by a 
completion routine at AST level to determine the next buffer to 
process. If an event flag was specified in the start sweep call, 
LPA$IWTBUF, not LPA$IGTBUF, should be called. 

The formats of the LPA$IGTBUF call are as follows: 



or. 



CALL LPA$IGTBUF ( IBUF, IBUFNO) 



IBUFNO=LPA$IGTBUF(IBUF) 
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Arguments are as described in Section 10.5.1.2, with the following 
additions: 

The IBUF array specified in the call that 
initiated the sweep. 



IBUF 



IBUFNO Returns the number of the next buffer to be filled 
or emptied by the application program. 

Table 10-6 lists the possible combinations of IBUFNO and IOSB contents 
on the return from a call to LPA$IGTBUF. The first four words of the 
IBUF array contain the IOSB. If IBUFNO is -1, the IOSB must be 
checked to determine the reason. 



IBUFNO 



n 
-1 



-1 



Table 10-6 
LPA$IGTBUF Call - IBUFNO and IOSB Contents 



IOSB(l) 








IOSB(2) 



(byte count) 




VAX/VMS 
error code 



IOSB(3) , (4) 









Meaning 



LPA11-K 

ready-out 
and maint. 

registers 
(only if 
SS$_DEVREQERR, 
SS$_CTRLERR, 

or 
SS$_DEVCMDERR 
is returned) 



Normal buffer complete. 

No buffers in queue. 
Request still active. 

No buffers in queue. 
Sweep terminated 
normally. 

No buffers in queue. 
Sweep terminated due to 
error condition. 
Section 10.6 describes 
the VAX/VMS error codes; 
Appendix A of the 
LPA11-K Laboratory 
Peripheral Accelerator 
User's Guide lists 
the LPA11-K error codes. 



10.5.15 LPA$INXTBF - Set Next Buffer to Use 

The LPA$INXTBF subroutine alters the normal buffer selection algorithm 
to allow the user to specify the next buffer to be filled or emptied. 
The specified buffer is reinserted at the head of the device queue. 

The two formats of the LPA$INXTBF call are as follows: 

CALL LPA$INXTBF ( IBUF , IBUFNO, IND) 

or, 

IND=LPA$ INXTBF ( IBUF, IBUFNO) 
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Arguments are as described in Section 10.5.1.2, with the followinq 
additions: ^ 



IBUF 



IBUFNO 



IND 



The IBUF array specified in the call that 
initiated the sweep. 

Specifies the number of the next buffer to be 
filled or emptied. The buffer must already be in 
the device queue. 

Returns the result of the call: 

= Specified buffer was not in the device queue 

1 = Next buffer was successfully set 



10.5.16 LPA$IWTBUF - Return Next Buffer or Wait 

The LPA$IWTBUF subroutine returns the next buffer to be processed by 
the application program, that is, the buffer at the head of the user 
queue. if the user queue is empty, LPA$IWTBUF waits until a buffer is 
available. If a completion routine was specified in the call that 
initiated the sweep, LPA$IGTBUF, not LPA$IWTBUF, should be called. 

The two formats of the LPA$IWTBUF call are as follows: 

CALL LPA$IWTBUF (IBUF, [IEFN] , IBUFNO) 

or, 

IBUFNO=LPA$IWTBUF(IBUF, [IEFN] ) 

Arguments are as described in Section 10.5.1.2, with the following 
additions: 



IBUF 



IEFN 



The IBUF array specified in the 
initiated the sweep. 



call 



that 



Not used. This argument is present for 
compatibility only. (The event flag is the one 
specified in the start sweep call.) 

IBUFNO Returns the number of the next buffer to be filled 
or emptied by the application program. 

Table 10-7 lists the possible combinations of IBUFNO and IOSB contents 
on the return from a call to LPA$IWTBUF. The first four words of the 
IBUF array contain the IOSB. If IBUFNO is -1, the IOSB must be 
checked to determine the reason. 
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Table 10-7 
LPA$IWTBUF Call - IBUFNO and IOSB Contents 



IBUFNO 



n 
-1 

-1 



IOSB(l) 




1 



VAX/VMS 
error code 



IOSB(2) 



(byte count) 




IOSB(3) , (4) 








Meaning 



LPA11-K 

ready-out 
and maint. 

registers 

(only if 
SS$_DEVREQERR, 
SS$_CTRLERR, 

or 
SS$_DEVCMDERR 
is returned) 



Normal buffer complete. 

No buffers in queue. 
Sweep terminated 
normally. 

No buffers in queue. 
Sweep terminated due to 
error condition. 
Section 10.6 describes 
the VAX/VMS error codes; 
Appendix A of the LPA11-K 
Laboratory Peripheral 
Accelerator User's Guide 
lists the LPA11-K error 
codes. 



10.5.17 LPA$RLSBUF - Release Data Buffer 

The LPA$RLSBUF subroutine declares one or more buffers available to be 
filled or emptied by the LPA11-K. LPA$RLSBUF inserts the buffer at 
the tail of the device queue (see Figure 10-4) . 

The format of the LPA$RLSBUF call is as follows: 

CALL LPA$RLSBUF (IBUF, [IND] , INDEXO , INDEX1 , . . . , INDEXN) 

Arguments are as described in Section 10.5.1.2, with the following 
additions: 



IBUF 



IND 



INDEXO, etc. 



The IBUF array specified in the call that 
initiated the sweep. 

Returns the success or failure status: 

= Illegal buffer number or incorrect number of 
arguments specified, or a double buffer overrun 
occurred. A double buffer overrun can occur if 
buffer overrun was specified as a non-fatal error, 
a buffer overrun occurs, and buffer was not 
released (probably on the user queue after a 
previous buffer overrun). LPA$_RLSBUF can return 
a double buffer overrun error only if buffer 
overrun was specified as a non-fatal error. 

1 = Buffer (s) released successfully 

Specify the indexes (0-7) of the buffers to be 
released. A maximum of eight indexes can be 
specified. 
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The LPA$RLSBUF subroutine must be called to release a buffer (or 
buffers) to the device queue before the sweep is initiated. (See 
Section 10.5.1.1 for a discussion on buffer management.) Note that 
LPA$RLSBUF does not verify whether or not the specified buffers are 
already in a queue. If a buffer is released when it is already in a 
queue, the queue pointers will be invalidated. This can cause 
unpredictable results. 



10.5.18 LPA$RMVBUF - Remove Buffer from Device Queue 

The LPA$RMVBUF subroutine removes a buffer from the device queue. 

The format of the LPA$RMVBUF call is as follows: 

CALL LPA$RMVBUF (IBUF, IBUFNO, [ IND] ) 

Arguments are as described in Section 10.5.1.2, with the following 
additions: 

IBUF The IBUF array specified in the call that 

initiated the sweep. 

IBUFNO Specifies the number of the buffer to remove from 
the device queue. 

IND Returns the success or failure status: 

= Buffer not found in the device queue 

1 = Buffer successfully removed from the device 
queue 



10.5.19 LPA$CVADF - Convert A/D Input to Floating Point 

The LPA$CVADF subroutine converts A/D input values to floating point 
numbers. LPA$CVADF is provided for compatibility reasons. 

The formats of the LPA$CVADF call are as follows: 

CALL LPA$CVADF (IVAL,VAL) 
or, 

VAL=LPA$CVADF ( IVAL) 

Argument descriptions are as follows: 

IVAL Contains the value (bits 11:0) read from the A/D 

input. Bits 15:12 are 0. 

VAL Receives the floating point value. 
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10.5.20 LPA$FLT16 - Convert Unsigned 16-bit Integer to Floating Point 

The LPA$FLP16 subroutine converts unsigned 16-bit integers to floating 
point. LPA$FLT16 is provided for compatibility reasons. 

The formats of the LPA$FLT16 call are as follows: 

CALL LPA$FLT16 (IVAL,VAL) 
or, 

VAL=LPA$FLT16 ( IVAL) 
Argument descriptions are as follows: 

IVAL An unsigned 16-bit integer. 

VAL Receives the converted value. 



10.5.21 LPA$LOADMC - Load Microcode and Initialize LPA11-K 

The LPA$LOADMC subroutine provides a program interface to the LPA11-K 
microcode loader. LPA$LOADMC sends a load request through a mailbox 
to the loader process to load microcode and initialize an LPA11-K 
(Section 10.7.1 describes the microcode loader process). 

The format of the LPA$LOADMC call is as follows: 

CALL LPA$LOADMC ( [ITYPE] [ ,NUM] [ , IND] [ , IERROR] ) 

Argument descriptions are as follows: 



ITYPE 



NUM 



IND 



IERROR 



VAX/VMS 



The type of microcode to be loaded, 
defines the following values: 

Value Meaning 

1 Multirequest mode 

2 Dedicated A/D mode 

3 Dedicated D/A mode 

If the ITYPE argument is defaulted, multirequest 
mode microcode is loaded. 

The number to be appended to the logical name 
LPA11$. If defaulted, NUM is 0. 

Receives the completion status: 

1 = Microcode loaded successfully. 

nnn = VAX/VMS error code 

Provides additional error information. Receives 
the second longword of the IOSB if either 
SS$_CTRLERR, SS$_DEVCMDERR, or SS$_DEVREQERR is 
returned in IND. Otherwise, the contents of 
IERROR is undefined. 
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10.6 I/O STATUS BLOCK 

The I/O status block format for the load microcode, start 
microprocessor, initialize LPA11-K, set clock, and start data transfer 
request QIO functions is shown in Figure 10-5. 



31 



16 15 



byte count 


status 


LPA11-K 
maintenance status 


LPA11-K ready-out 



Figure 10-5 I/O Functions IOSB Content 



VAX/VMS status val 
longword. Status 
count is the numbe 
If SS$_CTRLERR, 
status word, the 
Register and LPA11 
completion of the 
contains the spe 
LPA11-K Labo ratory 



ues and the byte count 
values are defined. 
r of bytes transferred 
SS$_DEVCMDERR, or SS 

second longword con 
-K Maintenance Status 
request. The high byt 
cific LPA11-K error 

Peripheral Accelerato 



lists the status returns for LPA11-K I/O 



are returned in the first 
by the $SSDEF macro. The byte 

by a I0$_L0ADMC0DE request. 
$_DEVREQERR is returned in the 
tains the LPA11-K Ready-out 
Register values present at the 
e of the Ready-out Register 

code (see Appendix A of the 
r User's Guide ) . Table 10-8 

functions. 



If high level language library procedures are used, the status returns 
listed in Table 10-8 can be returned from the resultant QIO functions. 
Since buffers are filled by these procedures asynchronously, two I/O 
status blocks are provided in the IBUF array: one for the high level 
language procedures and one for the LPA11-K driver. The first four 
words of the IBUF array contain the IOSB for the high level language 
procedures. 



Table 10-8 
LPA11-K Status Returns for I/O Functions 



Status 


Meaning 


SS$_AB0RT 


Request aborted. A request in progress was 
cancelled by the $CANCEL system service. (Only 
for start data transfer request functions.) 



(continued on next page) 
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Table 10-8 (Cont.) 
LPA11-K Status Returns for I/O Functions 



Status 



SS$ BUFNOTALIGN 



SS$ CANCEL 



SS$ CTRLERR 



SS$ DATACHECK 



SS$ DEVACTIVE 



SS$ DEVCMDERR 



Meaning 



Alignment error. If this error occurs for an 
initialize LPA11-K request, the initialize 
command table was not word-aligned. if this 
error occurs for a start data transfer request, 
there are several possible causes: 

• User status word (USW) not word-aligned 

• Buffer area not longword-aligned 

• Random Channel List (RCL) not word-aligned 

Request cancelled by the $CANCEL system service 
before it started. (Only for the initialize 
LPA11-K, set clock, and start data transfer 
request functions.) 



Controller err 
affects all 
occurs, the 
requests. Th 
IOSB contain 
Register and 
particular, th 
contains the 
Appendix A in 
Accelerator U 



or. This is a fa 
LPA11-K activity. 
LPA11-K terminate 
e third and fou 

the LPA11-K Re 
Maintenance Regist 
e high byte of 

specific LPA11-K 
the LPA11-K Labora 
ser's Guide) . (On 



tal error that 
If this error 
s all active 
rth words of the 
ady-out Status 
er contents. In 
the third word 
error code (see 
tory Peripheral 



microprocessor 
and start data 



~, initialize LPA11 
transfer request 



ly for the start 
-K, set clock, 
functions. ) 



Data check error. A mismatch between the 
microcode in memory and the microcode loaded 
into the LPA11-K was detected. The second word 
of the IOSB contains the number of bytes 
successfully loaded. (Only for the load 
microcode function.) 

Device is active. The microcode cannot be 
loaded or the microprocessor cannot be started 
because there is an active data transfer 
request. (Only for the load microcode and start 
microprocessor functions.) 



LPA11-K command error. This error is as 
with the issuance of a new LPA11-K comma 
third and fourth words of the IOSB cont 
LPA11-K Ready-out Status Regist 
Maintenance Register contents. In par 
the high byte of the third word cont 
specific LPA11-K error code (see Appendi 
the LPA11-K Laboratory Peripheral Ace 
User's Guide ) . (Only for the in 
LPA11-K, set clock, and start data 
request functions.) 



sociated 
nd. The 
ain the 
er and 
ticular , 
ains the 
x A in 
elerator 



itialize 
transfer 



(continued on next page) 
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Table 10-8 (Cont.) 
LPA11-K Status Returns for I/O Functions 



Status 



SS$ DEVREQERR 



SS$ EXQUOTA 



SS$ INSFBUFDP 



SS$ INSFMAPREG 



SS$ INSFMEM 



SS$ IVBUFLEN 



Meaning 



LPA11-K user request error. The third and 
fourth words of the IOSB contain the LPA11-K 
Ready-out Status Register and Maintenance 
Register contents. In particular, the high byte 
of the third word contains the specific LPA11-K 
error code (see Appendix A in the LPA11-K 
Laboratory Peripheral Accelerator User's Guide ) . 
(Only for start data transfer requests.) " ~ 

AST quota exceeded. An AST cannot be queued for 
a buffer full/empty AST. Normally, a start data 
transfer request can require no more than three 
AST blocks at a time. (Only for start data 
transfer requests.) 



A UBA-buffered datapath was not 
allocation. (Only for start 
requests in dedicated mode.) 



available for 
data transfer 



Insufficient UBA map registers to map the 
command table or buffer areas. If the map 
registers were preallocated when the driver was 
loaded, the preallocation should be increased. 
(Only for the initialize LPA11-K and start data 
transfer request functions.) 

Insufficient dynamic memory to start request or 
allocate an AST block. (Only for start data 
transfer requests.) 



Incorrect length. If this error occurs for an 
initialize LPA11-K request, the initialize 
command table length is not the required 278 
bytes. If this error occurs for a start data 

ransfer request, there are several possible 

auses: 

Command table length is not the required 40 
bytes 

Buffer area size is not evenly divisible by 
the number of buffers assigned 

Individual buffer size is 

Individual buffer size is not a multiple of 
2 for a multirequest mode request, or 4 for 
a dedicated mode request 



Random Channel List length is 
multiple of 2 



or not 



Bit 15 in the last word of the Random 
Channel List is not set 



(continued on next page) 
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Table 10-8 (Cont.) 
LPA11-K Status Returns for I/O Functions 



Status 


Meaning 


SS$_IVMODE 

SS$_MCNOTVALID 

SS$_PARITY 
SS$_POWERFAIL 

SS$_TIMEOUT 


Incorrect mode. The first three bits (2:0) of 
the first word in the command table, that is, 
the mode word, are not 0. (Only for the 
initialize LPA11-K function.) 

Microcode has not been successfully loaded. 
(Only for the start microprocessor, initialize 
LPA11-K, set clock, and start data transfer 
request functions.) 

Parity error. A parity error occurred in a 
UBA-buffered datapath. (Only for start data 
transfer request in dedicated mode.) 

A power failure occurred while a request was 
active. (Only for the start microprocessor, 
initialize LPA11-K, set clock, and start data 
transfer request functions.) 

Device timeout. An interrupt was not received 
within one second after the request was issued. 
(Only for the start microprocessor, initialize 
LPA11-K, set clock, and start data transfer 
request functions.) 



10.7 LOADING LPA11-K MICROCODE 

The microcode loading and device initialization routines automatically 
load microcode on system initialization (if specified in the system 
manager's startup file) and on power recovery. These routines also 
allow a non-privileged user to load microcode and restart the system. 

The LPA11-K loader and initialization routines consist of three parts: 

• A microcode loader process which loads any of the three 
microcode versions, initializes the LPA11-K, and sets the 
clock rate. Loading is initiated by either a mailbox request 
or a power recovery AST. This process requires permanent 
mailbox (PRMMBX) and physical I/O privileges. 

• An operator process which accepts operator commands or 
indirect file commands to load microcode and initialize an 
LPA11-K. This process uses a mailbox to send a load request 
to the loader process; temporary mailbox (TMPMBX) privilege 
is required. 

• An LPA11-K procedure library routine that provides a program 
interface to the LPA11-K microcode loader. The procedure 
sends a load request through a mailbox to the loader process 
to load microcode and initialize an LPA11-K. Section 10.5.21 
describes this routine in greater detail. 
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10.7.1 Microcode Loader Process 

The microcode loader process loads microcode, initializes a specific 
LPA11-K, and sets the clock at the default rate (10 kHz interrupt 
rate). A bit set in a controller bitmap indicates that the specified 
controller was loaded. The process specifies a power recovery AST, 
creates a mailbox whose name (LPA$LOADER) is entered in the system 
logical name table, and then hibernates. 

The correct device configuration is determined automatically. When 
LPA11-K initialization is performed, every possible device (see Table 
10-1) is specified as present on the LPAll-K. If the LPA11-K returns 
a device not found error, the LPAll-K is reinitialized with that 
device omitted. 

On receipt of a power recovery AST, the loader process examines the 
controller bitmap to determine which LPAll-Ks have been loaded. For 
each LPAll-K, the loader process performs the following functions: 

• Obtains device characteristics 

• Reloads the microcode previously loaded 

• Reinitializes the LPAll-K 

• Sets Clock A to the previous rate and preset value 



10.7.2 Operator Process 

The operator process loads microcode and initializes an LPAll-K 
through the use of either terminal or indirect file commands. The 
command input syntax is as follows: 

devname/type 

Devname is the device name of the LPAll-K to be loaded. A logical 
name can be specified. However, only one level of logical name 
translation is performed. If devname is omitted, LAAO is the default 
name, /type specifies one of three types of microcode to load: 

/MULTI_REQUEST = multirequest mode 
/ANALOG_DIGITAL = dedicated A/D mode 
/DIGITAL_ANOLOG = dedicated D/A mode 

If /type is omitted, /MULTI_REQUEST is the default. 

After receiving the command, the operator process formats a message 
and sends it to the loader process. Completion status is returned 
through a return mailbox. 



10.8 RSX-llM VERSION 3.1 AND VAX/VMS DIFFERENCES 

This section lists those areas where the VAX/VMS and RSX-llM Version 
3.1 LPAll-K high level language support routines differ. The RSX-llM 
I/O Drivers Reference Manual provides a detailed description of the 
RSX-llM LPAll-K support routines. The exact differences between the 
VAX/VMS and RSX-llM routines can be determined by comparing the 
descriptions in the RSX-llM manual with the descriptions for the 
VAX/VMS routines in the preceding sections of this guide. 
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10.8.1 Alignment and Length 
In VAX/VMS: 

• Buffers must be contiguous. 

• Buffers must be longword-aligned. 

• The Random Channel List must be word-aligned. 

• The IBUF array length is 50 longwords and must be 
longword-aligned . 

10.8.2 Status Returns 



In VAX/VMS 



The I/O Status Block length is 8 bytes; numeric values of 
errors are different. 

Several routines return: 

1 - Success 

- Failure detected in support routine 

nnn - VAX/VMS status code. Failure detected in system 
service. 



10.8.3 Sweep Routines 
In VAX/VMS: 

• If an event flag is specified, it must be within a %VAL( ) 
construction. 

• A tenth argument, IND, has been added to return the success or 
failure status. 



10.8.4 General 
In VAX/VMS: 

• The LUN argument is not used. Instead, the NUM argument 
specifies the number to be appended to the logical name 
LPA11$. 

• All routine names have the prefix LPA$ . 

• In the LPA$SETIBF routine, buffer addresses are checked for 
contiguity. 

• In the LPA$LAMSKS routine, the IUNIT argument is not used. 
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• In the LPA$IWTBUF routine, the IEFN argument is not used. The 
event flag specified in the sweep routine is used. 

• The combinations of IBUFNO and I/O Status Block values 
returned by the LPA$IWTBUF and LPA$IGTBUF routines are 
different. 

• If buffer overrun is specified as a non-fatal error, buffer 
must be released. However, buffer is set aside (placed on a 
queue) until a buffer overrun occurs. If a buffer overrun 
occurs and buffer was not released, the LPA$RLSBUF routine 
returns an error the next time buffer is released. 



10.9 PROGRAMMING EXAMPLES 

The following program examples use LPA11-K high level language 
procedures and LPA11-K Queue I/O functions. 
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10.9.1 LPA11-K High Level Language Program (Program A) 

This program is an example of how the LPA11-K high level language 
procedures perform an A/D sweep using three buffers. The program uses 
default arguments whenever possible to illustrate the simplest 
possible calls. The program assumes that dedicated mode microcode has 
previously been loaded into the LPA11-K. Table 10-9 lists the 
variables used in this program. 



Table 10-9 
Program A Variables 



Variable 



BUFFER 



IBUF 



BUFNUM 



I STAT 



Description 



The data buffer array. BUFFER is a common area to 
guarantee longword-alignment. 

The LPA11-K high level language procedures use the 
IBUF array for local storage. 

BUFNUM contains the buffer number returned by 
LPA$IWTBUF. in this example, the possible values are 
0, 1, and 2. 

ISTAT contains the status return from the high level 
language calls. 



Q ******************************************************************* 

C 

C PROGRAM A i 

C \ 

c ****************************************************************** 



INTEGER*2 BUFFER (1000 , : 2) ,I0SB(4) 
INTEGER*4 IBUF (50) , ISTAT, BUFNUM 



C0MM0N/AREA1/BUFFER 



EQUIVALENCE 



(IOSB(l) ,IBUF(1) ) 



C 
C 
C 



C 
C 
C 



C 
C 
C 
C 



C 
C 
C 



SET CLOCK RATE TO 100 KHZ, CLOCK PRESET TO -10 

CALL LPA$CLOCKA(2,-10,ISTAT) 
IF (.NOT. ISTAT) GO TO 950 

INITIALIZE IBUF ARRAY FOR SWEEP 

CALL LPA$SETIBF(IBUF, ISTAT, ,BUFFER(1,0) ,BUFFER(1,1) ,BUFFER(1,2) ) 
IF (.NOT. ISTAT) GO TO 950 

RELEASE ALL THE BUFFERS. NOTE USE OF BUFFER NUMBERS RATHER THAN 
BUFFER NAMES. 

CALL LPA$RLSBUF (IBUF , ISTAT, ,1,2) 
IF (.NOT. ISTAT) GO TO 950 

START A/D SWEEP 
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CALL LPA$ADSWP(IBUF,1000,50, ,,,,,, ISTAT) 

IF (.NOT. ISTAT) GO TO 950 
C 

C GET NEXT BUFFER FILLED WITH DATA. IF BUFNUM IS NEGATIVE, THERE 
C ARE NO MORE BUFFERS AND THE SWEEP IS STOPPED. 
C 
100 BUFNUM = LPA$IWTBUF(IBUF) 

IF (BUFNUM .LT. 0) GO TO 800 
C 
C PROCESS DATA IN BUFFER (1 , BUFNUM) TO BUFFER (1000 , BUFNUM) 



(Application dependent code is inserted at this point) 



C RELEASE BUFFER TO BE FILLED AGAIN 

C 

200 CALL LPA$RLSBUF(IBUF, ISTAT, BUFNUM) 

IF (.NOT. ISTAT) GO TO 950 

GO TO 100 
C 

C THERE ARE NO MORE BUFFERS TO PROCESS. CHECK TO ENSURE THAT THE 
C SWEEP ENDED SUCCESSFULLY. IOSB(l) CONTAINS EITHER 1 OR A 
C VAX/VMS STATUS CODE. 
C 
800 IF (.NOT. IOSB(l)) CALL LIB$STOP (%VAL ( IOSB (1) ) ) 

PRINT *, 'SUCCESSFUL COMPLETION' 

GO TO 2000 

C 

C ERROR RETURN FROM SUBROUTINE. ISTAT CONTAINS EITHER OR 

C VAX/VMS ERROR CODE. 

C 

950 IF (ISTAT .NE. 0) CALL LIB$STOP ( %VAL ( ISTAT) ) 

PRINT *, 'ERROR IN LPA11-K SUBROUTINE CALL' 
2000 STOP 

END 

c ******************************************************************* 
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10.9.2 LPA11-K High Level Language Program (Program B) 

This program is a more complex example of LPA11-K operations performed 
by the LPA11-K high level language procedures. The following 
operations are demonstrated: 

• Program requested loading of LPA11-K microcode 

• Setting the clock at a specified rate 

• Use of non-default arguments whenever possible 

• An A/D sweep that uses an event flag 

• A D/A sweep that uses a completion routine 

• Buffer overrun set (buffer overrun is a non-fatal error) 

• Random Channel List addressing 

• Sequential Channel addressing 

Table 10-10 lists the variables used in this program. 



Table 10-10 
Program B variables 



Variable 


Description 


AD 


An array of buffers for an A/D sweep (8 buffers of 
500 words each) 


DA 


An array of buffers for a D/A sweep (2 buffers of 
2000 words each) 


IBUFAD 


The IBUF array for an A/D sweep 


IBUFDA 


The IBUF array for a D/A sweep 


RCL 


The array containing the Random Channel List 


ADIOSB 


The array that contains the I/O status block for the 
A/D sweep. Equivalenced to the beginning of IBUFAD. 


DAIOSB 


The array that contains the I/O status block for the 
D/A sweep. Equivalenced to the beginning of IBUFDA. 


I STAT 


Contains the status return from the high level 
language calls 
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Q ******************************************************************* 
C 

C PROGRAM B 

C 

Q ***************************************************************** 

EXTERNAL FILLBF 
REAL*4 LPA$XRATE 

INTEGER*2 AD(500,0:7) ,DA (2000 ,0 : 1) ,RCL(5) ,MODE,IPRSET 
INTEGER*2 ADIOSB (4 ) ,DAIOSB (4) 

INTEGER*4 IBUFAD(50) ,IBUFDA(50) ,LAMSKB(2) 
INTEGER*4 ISTAT, IERROR, IRATE ,BUFNUM 

REAL*4 PERIOD 

COMMON /SWEEP/AD,DA,IBUFAD,IBUFDA 

EQUIVALENCE (IBUFAD(l) ,ADIOSB(l) ) , (IBUFDA(l) ,DAIOSB(l) ) 

PARAMETER MULTI=1, HBIT= ' 8000 ' X , LSTCHN=HBIT+7 
C 

C SET UP RANDOM CHANNEL LIST. NOTE THAT THE LAST WORD MUST HAVE BIT 
C 15 SET. 
C 

DATA RCL/2,6,3,4,LSTCHN/ 

Q ******************************************************************* 

c 

C LOAD MULTIREQUEST MODE MICROCODE AND SET THE CLOCK OVERFLOW RATE 

C TO 5 KHZ 

C 

Q ******************************************************************* 

C 

C LOAD MICROCODE ON LPA11-K ASSIGNED TO LPA11$3 
C 

CALL LPA$LOADMC (MULTI , 3 , ISTAT , IERROR) 

IF (.NOT. ISTAT) GO TO 5000 
C 

C COMPUTE CLOCK RATE AND PRESET. SET CLOCK 'A' ON LPA11-K 
C ASSIGNED TO LPAI1$3. 
C 

PERIOD = LPA$XRATE(. 0002, IRATE, IPRSET,0) 

IF (PERIOD .EQ. 0.0) GO TO 5500 

CALL LPA$CLOCKA ( IRATE , IPRSET , ISTAT ,3) 
IF (.NOT. ISTAT) GO TO 5000 

Q ******************************************************************* 

C 

C SET UP FOR A/D SWEEP 
C 

Q ******************************************************************* 

c 

C INITIALIZE IBUF ARRAY. NOTE THE USE OF THE LAMSKB ARGUMENT BECAUSE 

C THE LPA11-K ASSIGNED TO LPAll$3 IS USED. 

C 

CALL LPA$SETIBF(IBUFAD, ISTAT, LAMSKB, AD(1,0) ,AD(1,1) ,AD(1,2) , 
1 AD (1,3) , AD (1,4) , AD (1,5) , AD (1,6) , AD (1,7)) 

IF (.NOT. ISTAT) GO TO 5000 

CALL LPA$LAMSKS (LAMSKB, 3) 
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C SET UP RANDOM CHANNEL LIST SAMPLING (20 SAMPLES IN A SAMPLE 

C SEQUENCE) 

C 

CALL LPA$SETADC( IBUFAD,, RCL, 20,0, ISTAT) 

IF (.NOT. ISTAT) GO TO 5000 
C 

C RELEASE BUFFERS FOR A/D SWEEP 
C 

CALL LPA$RLSBUF ( IBUFAD , ISTAT ,0,1,2,3,4,5,6,7) 

IF (.NOT. ISTAT) GO TO 5000 

q ******************************************************************* 

C 

C SET UP FOR D/A SWEEP 

C 

C ******************************************************************* 

c 

C NOTE THAT THE SAME LAMSKB ARRAY CAN BE USED BECAUSE THE LAMSKB 

C CONTENTS APPLY TO BOTH A/D AND D/A SWEEPS 

C 

CALL LPA$SETIBF(IBUFDA, ISTAT, LAMSKB, DA(1,0) ,DA(1,1) ) 

IF (.NOT. ISTAT) GO TO 5000 
C 

C SET UP SAMPLING PARAMETERS AS FOLLOWS: INITIAL CHANNEL = 1. 
C NUMBER OF CHANNELS SAMPLED EACH SAMPLE SEQUENCE = 2, CHANNEL 
C INCREMENT = 2, THAT IS, SAMPLE CHANNELS 1 AND 3 EACH SAMPLE 
C SEQUENCE. 
C 

CALL LPA$SETADC ( IBUFDA ,,1,2,2, ISTAT) 

IF (.NOT. ISTAT) GO TO 5000 
C 

C FILL BUFFERS WITH DATA FOR OUTPUT TO D/A 
C 



(Application dependent code is inserted here to fill buffers 
DA(1,0) through DA(2000,0) and DA(1,1) through DA(2000,1) with data) 



C 

C RELEASE BUFFERS FOR D/A SWEEP 

C 

CALL LPA$RLSBUF (IBUFDA, ISTAT, , 1) 

IF (.NOT. ISTAT) GO TO 5000 

Q ***************************************************************** 

C 

C START BOTH SWEEPS 
C 

Q ***************************************************************** 

c 

C START A/D SWEEP. MODE BITS SPECIFY BUFFER OVERRUN IS NON-FATAL AND 

C MULTIREQUEST MODE. SWEEP ARGUMENTS SPECIFY 500 SAMPLES/BUFFER, 

C INDEFINITE SAMPLING, DWELL = 10 CLOCK OVERFLOWS, SYNCHRONIZE USING 

C EVENT FLAG 15, AND A DELAY OF 50 CLOCK OVERFLOWS. 

C 

MODE = 16384 + 64 

CALL LPA$ADSWP( IBUFAD, 500,0, MODE, 10, %VAL(15) ,50,,, ISTAT) 

IF (.NOT. ISTAT) GO TO 5000 
C 

C START D/A SWEEP. MODE SPECIFIES MULTIREQUEST MODE. OTHER 
C ARGUMENTS SPECIFY 2000 SAMPLES/BUFFER, FILL 15 BUFFERS, DWELL = 25 
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C CLOCK OVERFLOWS, SYNCHRONIZE BY CALLING THE COMPLETION ROUTINE 

C 'FILLBF', AND DELAY = 10 CLOCK OVERFLOWS. (SEE THE FILLBF LISTING 

C AFTER THE PROGRAM B LISTING.) 

C 

MODE =64 

CALL LPA$DASWP ( IBUFDA, 2000 ,15 , MODE ,25 , FILLBF, 10 , , , ISTAT) 

IF (.NOT. ISTAT) GO TO 5000 

Q ******************************************************************* 

C 

C WAIT FOR AN A/D BUFFER AND THEN PROCESS THE DATA IT CONTAINS. D/A 

C BUFFERS ARE FILLED ASYNCHRONOUSLY BY THE COMPLETION ROUTINE FILLBF. 

C 

C ******************************************************************* 

c 

C WAIT FOR A BUFFER TO BE FILLED BY A/D. IF BUFNUM IS LESS THAN 

C ZERO, THE SWEEP HAS STOPPED (EITHER SUCCESSFULLY OR WITH AN ERROR) . 

C 

100 BUFNUM = LPA$IWTBUF(IBUFAD) 

IF (BUFNUM .LT. 0) GO TO 1000 
C 

C THERE IS A/D DATA IN AD (1, BUFNUM) THROUGH AD (500 , BUFNUM) 
C 



(Process the A/D data with the application dependent code inserted 
here) 



C 

C ASSUME SWEEP SHOULD BE STOPPED WHEN THE LAST SAMPLE IN BUFFER 

C EQUALS 0. NOTE THAT THE SWEEP ACTUALLY STOPS WHEN THE BUFFER 

C CURRENTLY BEING FILLED IS FULL. ALSO NOTE THAT LPA$IWTBUF 

C CONTINUES TO BE CALLED UNTIL THERE ARE NO MORE BUFFERS TO PROCESS, 

C 

IF (AD (500, BUFNUM) .NE. 0) GO TO 200 

CALL LPA$STPSWP(IBUFAD,1, ISTAT) 

IF (.NOT. ISTAT) GO TO 5000 

C 

C AFTER THE DATA HAS BEEN PROCESSED, THE BUFFER IS RELEASED TO BE 

C FILLED AGAIN. THEN THE NEXT BUFFER IS OBTAINED FROM A/D. 

C 

200 CALL LPA$RLSBUF(IBUFAD, ISTAT, BUFNUM) 

IF (.NOT. ISTAT) GO TO 5000 

GO TO 100 

i 

C 

C ENTER HERE WHEN A/D SWEEP HAS ENDED. CHECK FOR ERROR OR 

C SUCCESSFUL END. (NOTE: ASSUME THAT THE D/A SWEEP HAS ALREADY 

C ENDED - SEE COMPLETION RQUTINE FILLBF) 

C 

1000 lF(ADIOSB(l)) GO TO 6000 

CALL LIB$STOP(%VAL(ADIOSB(l) )) 

C 

C ENTER HERE IF THERE WAS AN ERROR RETURNED FROM ONE OF THE 

C LPA11-K HIGH LEVEL LANGUAGE CALLS. ISTAT CONTAINS EITHER 

C OR A VAX/VMS STATUS CODE. 

C 

5000 IF (ISTAT .NE. 0) CALL LIB$STOP (%VAL (ISTAT) ) 

5500 PRINT *»'ERROR IN LPA11-K SUBROUTINE CALL' 
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GO TO 7000 

6000 PRINT *, 'SUCCESSFUL COMPLETION' 
7000 STOP 
END 

Q ******************************************************************* 

C 

C SUBROUTINE FILLBF 

C 

C ******************************************************************* 

C 

C THE FILLBF SUBROUTINE IS CALLED WHENEVER THE D/A HAS EMPTIED A 

C BUFFER, AND THAT BUFFER IS AVAILABLE TO BE REFILLED. THIS 

C SUBROUTINE GETS THE BUFFER, FILLS IT, AND RELEASES IT BACK TO THE 

C LPA11-K. NOTE THAT THE D/A SWEEP IS STOPPED AUTOMATICALLY AFTER 

C 15 BUFFERS HAVE BEEN FILLED. ALSO NOTE THAT FILLBF IS CALLED BY 

C AN AST HANDLER. IT IS THEREFORE CALLED ASYNCHRONOUSLY FROM THE 

C MAIN PROGRAM AT AST LEVEL. CARE SHOULD BE EXERCISED WHEN ACCESSING 

C VARIABLES THAT ARE COMMON TO BOTH LEVELS. 

C 

INTEGER*2 AD(500,0:7) ,DA(2000 ,0 : 1) ,DAIOSB(4) 

INTEGER*4 IBUFAD(50) ,IBUFDA(50) ,BUFNUM, ISTAT 

EQUIVALENCE (IBUFDA(l) ,DAIOSB(l)) 

COMMON /SWEEP/AD , DA , IBUFAD , IBUFDA 
C 

C GET BUFFER NUMBER OF NEXT BUFFER TO FILL 
C 

BUFNUM = LPA$IGTBUF (IBUFDA) 

IF (BUFNUM .LT. 0) GO TO 3000 

C 

C FILL BUFFER WITH DATA FOR OUTPUT TO D/A 



(Application dependent code is inserted here to fill buffer 
DA (1, BUFNUM) through DA (2000, BUFNUM) with data) 



C 

C RELEASE BUFFER 

C 

CALL LPA$RLSBUF (IBUFDA, ISTAT, BUFNUM) 

GO TO 4000 

C 

C CHECK FOR SUCCESSFUL END OF SWEEP 

C 

3000 IF(DAIOSB(l) ) GO TO 4000 

C 

C ERROR IN SWEEP 

C 

CALL LIB$STOP(%VAL(DAIOSB(l) ) ) 

4000 RETURN 

END 
C ******************************************************************* 
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10.9.3 LPA11-K QIO Functions Program (Program C) 

This sample program uses QIO functions to start an A/D data transfer 
from an LPA11-K. (The program assumes multirequest mode microcode has 
been loaded.) Sequential channel addressing is used. The data 
transfer is stopped after 100 buffers have been filled; no action is 
taken with the data as the buffers are filled. Note that this program 
starts the data transfer and then waits until the QIO operation 
completes. 



******************************************************************* 

PROGRAM C 
******************************************************************* 

.TITLE LPA11-K EXAMPLE PROGRAM 
.IDENT /V01/ 

.PSECT LADATA,LONG 



IOSB: 
COUNT: 

CBUFF: 



.BLKQ 
.LONG 



.WORD 



.WORD 



N X20A 





.LONG 


USW 






.LONG 


4000 






.LONG 


DATA 


BUFFERO 




.LONG 









.LONG 









• WORD 


10 






.BYTE 









.BYTE 


1 






.WORD 


16 






.WORD 


1 






.BYTE 









.BYTE 









.WORD 









.WORD 









.WORD 







USW: 


.WORD 









.ALIGN 


LONG 




DATA 


BUFFERO: 


.BLKW 


500 


data" 


"BUFFER1: 


• BLKW 


500 


data" 


"BUFFER2: 


• BLKW 


500 


data" 


"BUFFER3: 


.BLKW 


500 



I/O STATUS BLOCK 

COUNT OF BUFFERS FILLED 

COMMAND BUFFER FOR START 
DATA QIO 

MODE = SEQUENTIAL CHANNEL 
ADDRESSING, A/D, MULTI- 
REQUEST MODE 
VALID BUFFER MASK (4 
BUFFERS) 

USER STATUS WORD ADDRESS 
AGGREGATE BUFFER LENGTH 
ADDRESS OF DATA BUFFERS 
NO RANDOM CHANNEL LIST 
LENGTH 

NO RANDOM CHANNEL LIST 
ADDRESS 
DELAY 

START CHANNEL 
CHANNEL INCREMENT 
NUMBER OF SAMPLES IN 
SAMPLE SEQUENCE 
DWELL 

START WORD NUMBER 
EVENT MARK WORD 
START WORD MASK 
EVENT MARK MASK 
FILLS OUT COMMAND BUFFER 

; USER STATUS WORD 

; BUFFERS MUST BE 
; LONGWORD ALIGNED 

; DATA BUFFERS 



DEVNAME : . LONG 4 , LANAME 
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CHANNEL: .BLKW 1 
LANAME: .ASCII /LAAO/ 



; CONTAINS CHANNEL NUMBER 



START: 



5$: 



.PSECT LACODE,NOWRT 

.WORD 

$ASSIGN_S DEVNAME, CHANNEL 

BLBS R0,5$ 

BRW ERROR 



$QIOW_S , CHANNEL, #IO$_SETCLOCK, - 

IOSB,,,,#1,#~X143,#-500 
BLBC RO, ERROR 
MOVZWL IOSB,R0 
BLBC RO, ERROR 



CLRW 



usw 



ASSIGN CHANNEL 
NO ERROR 
ERROR 

SET CLOCK OVERFLOW RATE 
TO 2 KHZ. (1 MHZ RATE 
DIVIDED BY 500 PRESET) 



ERROR 

PICK UP I/O STATUS 

ERROR 

START DATA TRANSFER 
CLEAR USW (START WITH 
BUFFER 0) 
FILL 100 BUFFERS 



MOVL #100, COUNT 

$QIOW_S , CHANNEL,* I 0$_STARTDATA,- 

IOSB,,,CBUFF,#40,#BFRAST 
BLBC RO, ERROR ; ERROR 

; NOTE THAT THE QIO WAITS UNTIL IT FINISHES. NORMALLY, THE DATA IS 
; PROCESSED HERE AS THE BUFFERS ARE FILLED. CHECK FOR ERROR WHEN 
; THE QIO COMPLETES. 

PICK UP I/O STATUS 

ERROR 

ALL DONE - EXIT 

ENTER HERE IF ERROR. 
STATUS IN RO. 
PUSH ONTO STACK 
SIGNAL ERROR 



BUFFER AST ROUTINE. 
BFRAST IS CALLED WHENEVER 
A BUFFER IS FILLED. 

ADD 1 TO BUFFER NUMBER 
HANDLE WRAPAROUND 





MOVZWL 

BLBC 

RET 


IOSB,R0 
RO, ERROR 


ERROR: 








PUSHL 
CALLS 


RO 
#l,LIB$STOP 


BFRAST: 








.WORD 

INCB 

CMPZV 




USW+1 

#0,#3,USW+1,#3 




BLEQ 
CLRB 


10$ 
USW+1 


10$: 


DECL 
BGTR 
BISB 


COUNT 

20$ 

#"X40, USW+1 


20$: 


BICB 
RET 


#~X80, USW+1 



; USE BUFFER 

; DECREMENT BUFFER COUNT 

; ENOUGH BUFFERS FILLED - 

; SET STOP BIT 

; CLEAR DONE BIT 



. END START 
******************************************************************* 



10-48 



February 1979 



APPENDIX B 
I/O FUNCTION CODES 



This appendix lists the function codes and function modifiers defined 
in the $IODEF macro. The arguments for these functions are also 
listed. 



B.l TERMINAL DRIVER 

Function 

IO$_READVBLK 
IO$_READLBLK 
IO$_READPBLK 
10$ READPROMPT 



IO$_WRITEVBLK 
IO$_WRITELBLK 
10$ WRITEPBLK 



I0$_SETM0DE 
10$ SETCHAR 



I0$_SETM0DE ! IO$M_HANG"UP 
10$ SETCHAR! I0$M HANGUP 



I0$_SETM0DE!I0$M 
IO$_SETMODE!IO$M~ 
10$ SETCHAR! I0$M~ 
IO$^SETCHAR!IQ$M~ 

IO$_SENSEMODE 
10$ SENSECHAR 



CTRLCAST 
CTRLYAST 
CTRLCAST 
"CTRLYAST 



Modifier 

I0$M_N0ECH0 

I0$M_CVTL0W 

I0$M_N0FILTR 

I0$M_TIMED 

I0$M_PURGE 

IO$M_DSABLMBX 

I0$M TRMNOECHO 



IO$M_CANCTRLO 
IO$M_ENABLMBX 
IO$M NOFORMAT 



Arguments 

Pi - buffer address 
P2 - buffer size 
P3 - timeout 
P4 - read terminator 

block address 
P5 - prompt string 

buffer address! 
P6 - prompt string 

buffer size 1 

PI - buffer address 
P2 - buffer size 
P3 - (ignored) 
P4 - carriage control 
specified 

PI - characteristics 

buffer address 
P2 - Characteristics 

buffer size 
P3 - speed specifier 
P4 - fill specifier 
P5 - parity flags 



(none) 

PI - AST service routine address 

P2 - AST parameter 

P3 - access mode to deliver AST 



PI - Characteristics buffer address 
P2 - Characteristics buffer sizie 



Only for I0$_READPR0MPT 
2 0nly for IO$_WRITELBLK and I0$_WRITEVBLK 
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B.2 DISK DRIVERS 



Functions 

10$ READVBLK 

IO$~READLBLK 

IO$_READPBLK 

IO$_WRITEVBLK 

IO$_WRITELBLK 

IO$_WRITEPBLK 

IO$_SETMODE 
IO$_SETCHAR 

IO$_CREATE 
IO$_ACCESS 
IO$_DEACCESS 
IO$_MODIFY 
10$ DELETE 



Arguments 

PI - buffer address 
P2 - byte count 
P3 - disk address 



PI - characteristic buffer 
address 

Pi - FIB descriptor address 
P2 - file name string 

address 
P3 - result string length 

address 
P4 - result string descriptor 

address 
P5 - attribute list address 



Only for 10$ READPBLK and 10$ WRITEPBLK 
2 ~ ~ 

Only for I0$_CREATE and I0$_ACCESS 

Only for I0$_CREATE and I0$_DELETE 
B.3 MAGNETIC TAPE DRIVERS 



Modifiers 

I0$M_DATACHECK 
I0$M_INHRETRY 
I0$M INHSEEKl 



10$ INHRETRY 



I0$M_CREATE2 
I0$M_ACCESS2 
I0$M DELETE3 



Functions 

IO$_READVBLK 

IO$_READLBLK 

IO$_READPBLK 

I0$_WRITEVBLK 

IO$_WRITELBLK 

IO$_WRITEPBLK 

I0$_SETM0DE 
IO$_SETCHAR 

I0$_CREATE 
I0$_ACCESS 
IO$_DEACCESS 
I0$_M0DIFY 
10$ ACPCONTROL 



Arguments 

PI - buffer address 
P2 - byte count 



PI - characteristics buffer 
address 

Pi - FIB descriptor address 
P2 - file name string 

address 
P3 - result string length 

address 
P4 - result string descriptor 

address 
P5 - attribute list address 



IO$_SKIPFILE PI - skip n tape marks 

I0$_SKIPREC0RD PI - skip n records 

Only for read functions 
2 
Only for write functions 

3 0nly for I0$_CREATE and I0$_ACCESS 

Only for 10$ ACPCONTROL 



Modifiers 

IO$M_DATACHECK 
IO$M_INHRETRY 
IO$M_REVERSEl 
I0$M INHEXTGAP2 



IO$M_INHRETRY 
IO$M_INHEXTGAP 

I0$M_CREATE3 
I0$M_ACCESS3 
I0$M DMOUNT^ 



IO$M_INHRETRY 
I0$M INHRETRY 
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Functions Arguments 

IO$_MOUNT (none) 

IO$_REWIND (none) 
IO$_REWINDOFF 

10$ WRITEOF (none) 



I0$_SENSEM0DE (none) 

■^Only for read functions 

2 0nly for write functions 

3 0nly for I0$_CREATE and I0$_ACCESS 

4 Only for I0$_ACPC0NTR0L 



Modifiers 



IO$M_INHRETRY 
I0$M_N0WAIT 

IO$M_INHEXTGAP 
IO$M_INHRETRY 

I0$M INHRETRY 



B.4 LINE PRINTER DRIVER 

Functions Arguments Modifiers 

IO$_WRITEVBLK PI - buffer address (none) 

IO$_WRITELBLK P2 - buffer size 
IO$_WRITEPBLK P3 - (ignored) 

P4 - carriage control 
specif ierl 

I0$_SETM0DE Pi - characteristics buffer (none) 
IO$_SETCHAR address 

lOnly for IO$_WRITEVBLK and IO$_WRITELBLK 



B.5 CARD READER DRIVER 



Functions 

IO$_READLBLK 
IO$_READVBLK 
IO$_READPBLK 

I0$_SETM0DE 
10$ SETCHAR 



Arguments 

PI - buffer address 
P2 - byte count 



PI - characteristics 
buffer address 



Modifiers 

IO$M_BINARY 
I0$M PACKED 



(none) 



10$ SENSEMODE (none) 



B.6 MAILBOX DRIVER 

Functions 

IO$_READVBLK 

IO$~READLBLK 

IO$_READPBLK 

IO$_WRITEVBLK 

IO$_WRITELBLK 

IO$_WRITEPBLK 

10$ WRITEOF 



Arguments 

PI - buffer address 
P2 - buffer size 



(none) 



IO$_SETMODE!IO$M_READATTN Pi - AST address 
10$ SETM0DE!I0$M WRTATTN Pi - AST parameter 



Modifiers 
IO$M NOW 
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I/O FUNCTION CODES 



Functions 



10$ 


READLBLK 


I0$" 


READPBLK 


10$ 


READVBLK 


10$ 


WRITELBLK 


10$ 


WRITEPBLK 


I0$_ 


_WRITEVBLK 


10$ 


SETMODE 


I0$_ 


_SETCHAR 


10$ 


SETMODE! IO$M 


10$ 


SETCHAR!IO$M 



ATTNAST 



PI 
P2 
P6 



PI - 



PI - 



P2 
P3 



Arguments 

buffer address 
message size 
diagnostic buffer 2 



characteristics 
buffer address 

AST service 

routine address 

(ignored) 

AST access mode 



Modifiers 

I0$M DSABLMBXl 
I0$M~N0Wl 
I0$M ENABLMBX 3 



I0$_SETM0DE! I0$M_SHUTD0WN 
IO$_SETCHARI I0$M_SHUTD0WN 

I0$_SETM0DE1 IO$M_STARTUP 
10$ SETCHAR!IO$M STARTUP 



PI 



PI 

P2 
P3 



- characteristics 
block address 

- characteristics 
block address 
(ignored) 
receive message 
blocks 



ionly for IO$_READPBLK and IO$_WRITEPBLK 
2 0nly for IO$_READLBLK and 10$ READPBLK 
3 0nly for 10$ WRITELBLK and I0l?_WRITEPBLK 



B.8 ACP INTERFACE DRIVER 



Functions 

I0$_CREATE 
I0$_ACCESS 
IO$_DEACCESS 
I0$_M0DIFY 
10$ DELETE 



Arguments 

Pi - FIB descriptor address 
P2 - file name string 

address 
P3 - result string length 

address 



10$ ACPCONTROL P4 



Modifiers 

IO$M_CREATE 1 
IO$M_ACCESS 1 
IO$M_DELETE 2 
I0$M DMOUNT 3 



result string descriptor 
address 
P5 - attribute list address 



10$ MOUNT 



(none) 



iQnly for I0$_CREATE and I0$_ACCESS 
2 0nly for I0$_CREATE and I0$_DELETE 
3 0nly for I0$_ACPC0NTR0L 
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B.9 LPA11-K DRIVER 



I/O FUNCTION CODES 



QIO Functions 



Arguments 



Modifier 



10$ LOADCODE 



IO$_STARTMPROC 
IO$_INITIALIZE 

10 SETCLOCK 



10$ STARTDATA 



Pi - starting address of 

microcode to be loaded 
P2 - load byte count 
P3 - starting microprogram 
address to receive 
microcode 

(none) 

PI - address of Initialize 

Command Table 
P2 - initialize command 

buffer length 

P2 - mode of operation 
P3 - clock control and 

status 
P4 - real-time clock preset 

value (2's complement) 

PI - Data Transfer Command 

Table address 
P2 - Data Transfer Command 

Table length 
P3 - normal completion AST 

address 
P4 - overrun completion AST 

address 



(none) 



(none) 
(none) 

(none) 



I0$M SETEVF 



High Level Language 
Subroutines 



Functions 



LPA$ADSWP 

LPA$DASWP 

LPA$DISWP 

LPA$D0SWP 

LPA$LAMSKS 

LPA$SETADC 

LPA$SETIBF 

LPA$STPSWP 

LPA$CLOCKA 

LPA$CLOCKB 

LPA$XRATE 

LPA$IBFSTS 

LPA$IGTBUF 

LPA$INXTBF 

LPA$IWTBUF 

LPA$RLSBUF 

LPA$RMVBUF 

LPA$CVADF 

LPA$FLT16 

LPA$LOADMC 



Start A/D converter sweep 

Start D/A converter sweep 

Start digital input sweep 

Start digital output sweep 

Specify LPA11-K controller and digital mask words 

Specify channel select parameters 

Specify buffer parameters 

Stop sweep 

Set Clock A rate 

Set closk B rate 

Compute clock rate and present value 

Return buffer status 

Return next available buffer 

Alter buffer order 

Return next buffer or wait 

Release buffer to LPA11-K 

Remove buffer from device queue 

Convert A/D input to floating point 

Convert unsigned integer to floating point 

Load microcode and initialize LPA-11K 
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INDEX 



7-2, 8-2 



$ASSIGN, 1-13, 2-3, 
$CREMBX, 1-14, 7-2 
$GETCHN, 1-24 
$GETDEV, 1-24 
$ INPUT, 1-19 
$OUTPUT, 1-19 

$QIO and $QIOW device/function 
independent arguments, 1-16 
$QIO macro, 1-15 
$QIOW macro, 1-16 
$WAITFR, 1-15 



026 code, 6-2 
029 code, 6-2 



Attention AST, 

enable DMC11, 8-8 

read, 7-7 

write, 7-7 
Attribute control block, 9-11 
Attributes, ACP QIO, 9-12 



B 

Beginning-of-tape (BOT) , 4-10 
Block-addressable devices, 1-8, 

1-10 
Buffer overrun, 10-10, 10-11 
Buffered I/O byte count quota, 

1-4 
Buffered I/O quota, 1-3, 7-5 



8-bit ASCII, 2-13 



Access, 1-5, 1-6, 1-14 
Access file, A-2 
ACP functions, 9-1 
ACP interface driver I/O 

functions, B-4 
ACP QIO functions, 9-1, 9-9 

arguments, 9-2 

attributes, 9-12 

disk magnetic tape and, A-l 

function modifiers, 9-2 

status returns, 9-14 
Allocate contiguous space, 9-7 
Allocate Device ($ ALLOC) system 

service, 1-14 
ALTMODE, 2-8 
Ancillary control process (ACP) , 

9-1 
Analog to digital, 10-1 
Arguments, 1-15 

ACP QIO functions, 9-2 

device/function dependent, 
1-18 

device/function independent, 
1-16 

I/O function codes, B-l 
Assign I/O Channel ($ASSIGN) 

system service, 1-13, 7-2 
Assigning channels, 1-13 
AST address, 1-18 
AST parameter, 1-18 
AST quota, 1-4, 7-5 
Asynchronous System Traps, 1-23 



CALL, 1-23 

Card punch combinations, 6-2 

Card reader, 

device characteristics, 6-4 

end-o f-file, 6-2 

I/O functions, 6-5, B-3 

I/O status block, 6-8 

read function, 6-6 

set characteristic, 6-7 

set mode, 6-7 

status returns, 6-8 

translation mode, 6-2 
Carriage control, 

line printer, 5-5 

terminal, 2-17 
Channels, 1-13 
Channel assignments, 1-13 
Channel number, 1-17 
Character bit mask, 

terminator, 2-16 
Character formatting, line 

printer, 5-2 
Character interpretation, 2-8 
Characteristics (see Device 

characteristics) 
Close check, 9-5 
Completion status, 1-19, 1-22 
Console terminal, 2-1 
Contiguous space , 

allocate, 9-7 
Control characters, 

terminal, 2-5 
Create file, A-l 
Create Mailbox and Assign 

Channel ($CREMBX) system 
service, 1-14, 7-2 
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INDEX (Cont.) 



CTRL/C, 2-5, 2-23 
CTRL/C AST, 

enable, 2-23 
CTRL/I, 2-5 
CTRL/ J, 2-5 
CTRL/K, 2-6 
CTRL/L, 2-6 
CTRL/0, 2-6 
CTRL/Q, 2-6, 2-12 
CTRL/R, 2-6 
CTRL/S, 2-6, 2-12 
CTRL/U, 2-7 
CTRL/X, 2-7 
CTRL/Y, 2-7, 2-23 
CTRL/Y AST, 

enable, 2-23 
CTRL/Z, 2-7 



Data check, 

disk, 3-2, 3-9, 3-10 
magnetic tape, 4-2, 4-9, 4-10 
Data interpretation, 2-8, 2-13 
Data overrun, 10-10 
Data Transfer Command Table, 

10-10, 10-11 
Data Transfer Stop Command, 

10-12 
DDCMP, 8-1, 8-4 
Deaccess file, A-4 
Deaccess lock, 9-5 
Deassign I/O channel (DEASSGN) 

system service, 7-3 
Dedicated mode (LPA11-K) , 10-2 
DELETE, 2-8 
Delete file, A-6 
Delete mailbox ($DELMBX) system 

service, 7-3 
Device allocation, 1-14 
Device characteristics, 
card reader, 6-3 
disk, 3^-4 
DMC11, 8-3 

line printer, 5-3, 5-4 
LPA11-K, 10-4 
magnetic tape, 4-3 
mailbox, 7-4 
terminal, 2-10 
Device information, 1-23 
Device-dependent 

characteristics, line 
printer, 5-4 
Device-independent 

characteristics, line 
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